Wireless Java

Name

javax.microedition.lcdui.Command

Synopsis

This class encapsulates the semantic information of an action. The command itself contains only information about a command, but not the actual action that happens when a command is activated. The action is defined in a CommandListener object associated with the screen. The Command class constructor takes three parameters, and therefore contains the following three pieces of information: label, command type, and priority.

Label

A string used for the visual representation of the command. For example, the label may appear next to a soft button on the device or as an element in a menu.

Command Type

An integer that specifies the command intent. The defined types are: BACK, CANCEL, EXIT, HELP, ITEM, OK, SCREEN, and STOP. The meaning of these types is explained in Table E-1.

Table E-1. Command types

Command Type	Description
BACK	A navigation command that returns the user to the logically previous screen.
CANCEL	A command that is a standard negative answer to a dialog implemented by the current screen. With this command type, the application hints to the implementation that the user wants to dismiss the current screen without taking any action, and usually that the user wants to go back to the prior screen. Hence, CANCEL is often interchangeable with BACK.
EXIT	A command used for exiting from the application.
HELP	A command that specifies a request for online help.
ITEM	An application with this command type hints to ...