javax.microedition.lcdui
Class Item

java.lang.Object
  |
  +--javax.microedition.lcdui.Item
Direct Known Subclasses:
ChoiceGroup, DateField, Gauge, ImageItem, StringItem, TextField

public abstract class Item
extends Object

A superclass for interactive components that can be added to a Form. All Item objects have a label field, which is a string that is attached to the item. The label is typically displayed near the component when it is displayed within a screen. This means that the implementation tries to keep the label on the same horizontal row with the item or directly above the item. If the screen is scrolling, the implementation tries to keep the label visible at the same time with the Item.

In some cases, when the user attempts to interact with an Item, the system will switch to a system-generated screen where the actual interaction takes places. If this occurs, the label will generally be carried along and displayed within this new screen in order to provide the user with some context for the operation. For this reason it is recommended that applications supply a label to all interactive Item objects. However, this is not required, and a null value for a label is legal and specifies the absence of a label.

Version:
MIDP 0.95 Public Draft

Method Summary
 String getLabel()
          Gets the label of this Item object.
 void setLabel(String label)
          Sets the label of the Item.
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getLabel

public String getLabel()
Gets the label of this Item object.
Returns:
the label string

setLabel

public void setLabel(String label)
Sets the label of the Item. If label is null, specifies that this item has no label.
Parameters:
label - the label string