|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object
|
+--javax.microedition.lcdui.Item
|
+--javax.microedition.lcdui.StringItem
An item that can contain a string. A StringItem is display-only; the user
cannot edit the contents. Both the label and the textual content of a
StringItem may be modified by the application. The visual representation
of the label may differ from that of the textual contents.
| Field Summary |
| Fields inherited from class javax.microedition.lcdui.Item |
BUTTON, HYPERLINK, LAYOUT_2, LAYOUT_BOTTOM, LAYOUT_CENTER, LAYOUT_DEFAULT, LAYOUT_EXPAND, LAYOUT_LEFT, LAYOUT_NEWLINE_AFTER, LAYOUT_NEWLINE_BEFORE, LAYOUT_RIGHT, LAYOUT_SHRINK, LAYOUT_TOP, LAYOUT_VCENTER, LAYOUT_VEXPAND, LAYOUT_VSHRINK, PLAIN |
| Constructor Summary | ||
StringItem(String label,
String text)
Creates a new StringItem object with the given label and textual content. |
||
StringItem(String label,
String text,
int appearanceMode)
Creates a new StringItem object with the given label,
textual content, and appearance mode. |
||
| Method Summary | ||
int |
getAppearanceMode()
Returns the appearance mode of the StringItem. |
|
Font |
getFont()
Gets the application's preferred font for rendering this StringItem. |
|
String |
getLabel()
Gets the label of this Item object. |
|
String |
getText()
Gets the text contents of the StringItem, or null if the StringItem is
empty. |
|
void |
setFont(Font font)
Sets the application's preferred font for rendering this StringItem. |
|
void |
setLabel(String label)
Sets the label of the Item. |
|
void |
setText(String text)
Sets the text contents of the StringItem. |
|
| Methods inherited from class javax.microedition.lcdui.Item |
addCommand, getLayout, getMinimumHeight, getMinimumWidth, getPreferredHeight, getPreferredWidth, notifyStateChanged, removeCommand, setDefaultCommand, setItemCommandListener, setLayout, setPreferredSize |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public StringItem(String label, String text)
Creates a new StringItem object with the given label and textual content.
Calling this constructor is equivalent to calling
StringItem(label, text, PLAIN);
RIM Implementation Note
Either label or text may be present or null.
label - the Item labeltext - the text contentspublic StringItem(String label, String text, int appearanceMode)
StringItem object with the given label,
textual content, and appearance mode.
Either label or text may be present or null.
The appearanceMode parameter
(see Appearance Modes)
is a hint to the platform of the application's intended use
for this StringItem. To provide hyperlink- or
button-like behavior,
the application should associate a default Command with this
StringItem and add an
ItemCommandListener to this
StringItem.
Here is an example showing the use of a
StringItem as a button:
|
label - the StringItem's label, or null
if no labeltext - the StringItem's text contents, or
null if the contents are initially emptyappearanceMode - the appearance mode of the StringItem,
one of Item.PLAIN, Item.HYPERLINK, or Item.BUTTONIllegalArgumentException - if appearanceMode invalid| Method Detail |
public int getAppearanceMode()
StringItem.
See Appearance Modes.Item.PLAIN, Item.HYPERLINK, or Item.BUTTONpublic Font getFont()
StringItem. The
value returned is the font that had been set by the application,
even if that value had been disregarded by the implementation.
If no font had been set by the application, or if the application
explicitly set the font to null, the value is the default
font chosen by the implementation.StringItemsetFont(javax.microedition.lcdui.Font)public String getText()
StringItem, or null if the StringItem is
empty.public void setFont(Font font)
StringItem.
The font is a hint, and the implementation may disregard
the application's preferred font.
The font parameter must be a valid Font
object or null. If the font parameter is
null, the implementation must use its default font
to render the StringItem.
font - the preferred font to use to render this
StringItemgetFont()public void setText(String text)
StringItem. If text is null, the StringItem
is set to be empty.text - the new content
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
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.