Use is subject to License Terms. Your use of this web site or any of its contents or software indicates your agreement to be bound by these License Terms.

Copyright © 2006 Sun Microsystems, Inc. and Motorola, Inc. All rights reserved.

MID Profile

javax.microedition.lcdui
Interface ItemStateListener


public interface ItemStateListener

This interface is used by applications which need to receive events that indicate changes in the internal state of the interactive items within a Form screen.

Since:
MIDP 1.0
See Also:
Form.setItemStateListener(ItemStateListener)

Method Summary
 void itemStateChanged(Item item)
          Called when internal state of an Item has been changed by the user.
 

Method Detail

itemStateChanged

public void itemStateChanged(Item item)
Called when internal state of an Item has been changed by the user. This happens when the user:

It is up to the device to decide when it considers a new value to have been entered into an Item. For example, implementations of text editing within a TextField vary greatly from device to device.

In general, it is not expected that the listener will be called after every change is made. However, if an item's value has been changed, the listener will be called to notify the application of the change before it is called for a change on another item, and before a command is delivered to the Form's CommandListener. For implementations that have the concept of an input focus, the listener should be called no later than when the focus moves away from an item whose state has been changed. The listener should be called only if the item's value has actually been changed.

The listener is not called if the application changes the value of an interactive item.

Parameters:
item - the item that was changed

MID Profile

Copyright © 2006 Sun Microsystems, Inc. and Motorola, Inc. All rights reserved. Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

For more information, please consult the JSR 118 specification.