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.

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

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 components that can be added to a Form and Alert. 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.

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, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

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

getLabel

public String getLabel()

Gets the label of this Item object.

Returns:

the label string