net.rim.device.api.ui
Interface FieldChangeListener

All Known Implementing Classes:
KeywordFilterField, Dialog

public interface FieldChangeListener

Listener interface for handling Field change events.

Classes that want to handle change events should implement this interface. Field classes identify the listener object to handle change events with their setChangeListener method.

Note: A listener may get notified by an unexpected field. For example, suppose one registers to listen to a ChoiceField. If the user puts the field into "change option" mode, this funtion will be called from that instance. Use Field.getOriginal() to find out what the original field is.

See Also:
Field.setChangeListener(FieldChangeListener), Field.getOriginal()

Field Summary
static int PROGRAMMATIC
          Indicates field change was done programmatically.
 
Method Summary
 void fieldChanged(Field field, int context)
          Invoked by a field when a property changes.
 

Field Detail

PROGRAMMATIC

public static final int PROGRAMMATIC
Indicates field change was done programmatically.
Method Detail

fieldChanged

public void fieldChanged(Field field,
                         int context)
Invoked by a field when a property changes.

Parameters:
field - The field that changed.
context - Information specifying the origin of the change. The context value is used to provide detail information about how the field was changed. For example, see ChoiceField#CONTEXT_CHANGE_OPTION to find out the context information in ChoiceField. Please check individual fields for more details.



Copyright 1999-2009 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.