| java.lang.Object
 javax.microedition.lcdui.Item
javax.microedition.lcdui.StringItem
| StringItem | | public class StringItem extends Item (Code) | | 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.
|
| Constructor Summary | |
| public | StringItem(String label, String text)
Creates a new StringItem object. | | public | StringItem(java.lang.String label, java.lang.String text, int appearanceMode)
Creates a new 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. |
| Method Summary | |
| public int | getAppearanceMode()
Returns the appearance mode of the StringItem. | | public Font | getFont()
Gets the application's preferred font for
rendering this StringItem. | | public String | getText()
Gets the text contents of the StringItem, or
null if the StringItem is
empty. | | public void | setFont(Font font)
Sets the application's preferred font for
rendering this 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. | | public void | setPreferredSize(int width, int height)
Sets the preferred width and height for this Item.
Values for width and height less than -1 are illegal.
If the width is between zero and the minimum width, inclusive,
the minimum width is used instead.
If the height is between zero and the minimum height, inclusive,
the minimum height is used instead.
Supplying a width or height value greater than the minimum width or
height locks that dimension to the supplied
value. | | public void | setText(String text)
Sets the text contents of the StringItem. |
| appearanceMode | | int appearanceMode(Code) | | The appearance hint
|
| font | | Font font(Code) | | The Font to render this StringItem's text in
|
| stringItemLF | | StringItemLF stringItemLF(Code) | | The look&feel associated with this StringItem.
Set in the constructor. getLF() should return this instance.
|
| StringItem | | public StringItem(String label, String text)(Code) | | Creates a new StringItem object. Calling this
constructor is equivalent to calling
StringItem(label, text, PLAIN);
|
Parameters:
label - the Item label
Parameters:
text - the text contents
See Also: StringItem.StringItem(String,String,int) |
| StringItem | | public StringItem(java.lang.String label, java.lang.String text, int appearanceMode)(Code) | | Creates a new 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:
StringItem strItem =
new StringItem("Default: ", "Set",
Item.BUTTON);
strItem.setDefaultCommand(
new Command("Set", Command.ITEM, 1);
// icl is ItemCommandListener
strItem.setItemCommandListener(icl);
|
Parameters:
label - the StringItem's label, or nullif no label
Parameters:
text - the StringItem's text contents, ornull if the contents are initially empty
Parameters:
appearanceMode - the appearance mode of the StringItem,one of StringItem.PLAIN, StringItem.HYPERLINK, or StringItem.BUTTON
throws:
IllegalArgumentException - if appearanceMode invalid |
| getFont | | public Font getFont()(Code) | | Gets the application's preferred font for
rendering this 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.
the preferred font to use to render thisStringItem
See Also: StringItem.setFont |
| getText | | public String getText()(Code) | | Gets the text contents of the StringItem, or
null if the StringItem is
empty.
a string with the content of the item
See Also: StringItem.setText |
| setFont | | public void setFont(Font font)(Code) | | Sets the application's preferred font for
rendering this 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.
Parameters:
font - the preferred font to use to render thisStringItem
See Also: StringItem.getFont |
| setPreferredSize | | public void setPreferredSize(int width, int height)(Code) | | Sets the preferred width and height for this Item.
Values for width and height less than -1 are illegal.
If the width is between zero and the minimum width, inclusive,
the minimum width is used instead.
If the height is between zero and the minimum height, inclusive,
the minimum height is used instead.
Supplying a width or height value greater than the minimum width or
height locks that dimension to the supplied
value. The implementation may silently enforce a maximum dimension for
an Item based on factors such as the screen size.
Supplying a value of
-1 for the width or height unlocks that dimension.
See Item Sizes for a complete discussion.
It is illegal to call this method if this Item
is contained within an Alert.
Parameters:
width - the value to which the width should be locked, or-1 to unlock
Parameters:
height - the value to which the height should be locked, or-1 to unlock
throws:
IllegalArgumentException - if width or height is less than-1
throws:
IllegalStateException - if this Item is containedwithin an Alert
See Also: StringItem.getPreferredHeight
See Also: StringItem.getPreferredWidth |
| setText | | public void setText(String text)(Code) | | Sets the text contents of the StringItem. If text
is null,
the StringItem
is set to be empty.
Parameters:
text - the new content
See Also: StringItem.getText |
|
|