org.zkoss.zk.ui.event
Class InputEvent

java.lang.Object
  org.zkoss.zk.ui.event.Event
      org.zkoss.zk.ui.event.InputEvent

Direct Known Subclasses:

ErrorEvent

public class InputEvent
extends Event

Represents an event cause by user's input something at the client.

Author:

tomyeh

See Also:

InputableX, Inputable

Constructor Summary

InputEvent(java.lang.String name, Component target, java.lang.String val)
Constructs a input-relevant event.

InputEvent(java.lang.String name, Component target, java.lang.String val, boolean selbk, int start)
Constructs an event for onChanging.

Method Summary

int	getStart() Returns the start position of the cursor from the input element.
java.lang.String	getValue() Returns the value that user input.
boolean	isChangingBySelectBack() Returns whether this event is onChanging, and caused by user's selecting a list of items.

Methods inherited from class org.zkoss.zk.ui.event.Event

getData, getName, getPage, getTarget, isPropagatable, stopPropagation, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

InputEvent

public InputEvent(java.lang.String name,
                  Component target,
                  java.lang.String val)

Constructs a input-relevant event.

Parameters:

val - the new value

InputEvent

public InputEvent(java.lang.String name,
                  Component target,
                  java.lang.String val,
                  boolean selbk,
                  int start)

Constructs an event for onChanging.

Parameters:

selbk - whether this event is caused by user's selecting a list of items. Currently, only combobox might set it to true for the onChanging event. See isChangingBySelectBack() for details.

Method Detail

getValue

public final java.lang.String getValue()

Returns the value that user input.

isChangingBySelectBack

public final boolean isChangingBySelectBack()

Returns whether this event is onChanging, and caused by user's selecting a list of items.

It is always false if it is caused by the onChange event.

Currently, only combobox might set it to true for the onChanging event. It is useful when you implement autocomplete. To have better response, you usually don't filter out unmatched items if this method returns true. In other words, you simply ignore the onChanging event if this method return true, when implementing autocomplete.

getStart

public int getStart()

Returns the start position of the cursor from the input element.

Note: In IE browser, we cannot get the position of cursor because onblur event of Javascript is always fired before onChange is fired. To get the position of cursor, onChanging event is suggested since onblur event of Javascript will not be fired.

Returns:

the start position >= 0

Since:

3.0.1