org.zkoss.zk.ui.event
Class InputEvent

java.lang.Object
  extended by org.zkoss.zk.ui.event.Event
      extended by 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

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
static InputEvent getInputEvent(AuRequest request)
          Converts an AU request to an input event.
 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 predefined values (aka., items).
 
Methods inherited from class org.zkoss.zk.ui.event.Event
getData, getEvent, 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

getInputEvent

public static final InputEvent getInputEvent(AuRequest request)
Converts an AU request to an input event.

Since:
5.0.0

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 predefined values (aka., 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


Copyright © 2005-2009 Potix Corporation. All Rights Reserved. SourceForge.net Logo