FileDocCategorySizeDatePackage
CommandListener.javaAPI DocJ2ME MIDP 2.01796Thu Nov 07 12:02:26 GMT 2002javax.microedition.lcdui

CommandListener

public interface CommandListener
This interface is used by applications which need to receive high-level events from the implementation. An application will provide an implementation of a CommandListener (typically by using a nested class or an inner class) and will then provide the instance to the addCommand method on a Displayable in order to receive high-level events on that screen.

The specification does not require the platform to create several threads for the event delivery. Thus, if a CommandListener method does not return or the return is not delayed, the system may be blocked. So, there is the following note to application developers:

  • the CommandListener method should return immediately.
see
javax.microedition.lcdui.Displayable#setCommandListener
since
MIDP 1.0

Fields Summary
Constructors Summary
Methods Summary
public voidcommandAction(Command c, Displayable d)
Indicates that a command event has occurred on Displayable d.

param
c a Command object identifying the command. This is either one of the applications have been added to Displayable with {@link Displayable#addCommand(Command) addCommand(Command)} or is the implicit {@link List#SELECT_COMMAND SELECT_COMMAND} of List.
param
d the Displayable on which this event has occurred