|
MID Profile | |||||||||
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.
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. |
|
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 |
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 |
setPreferredSize(int width,
int height)
Sets the preferred width and height for this Item . |
void |
setText(String text)
Sets the text contents of the StringItem . |
Methods inherited from class javax.microedition.lcdui.Item |
addCommand, getLabel, getLayout, getMinimumHeight, getMinimumWidth, getPreferredHeight, getPreferredWidth, notifyStateChanged, removeCommand, setDefaultCommand, setItemCommandListener, setLabel, setLayout |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public StringItem(String label, String text)
StringItem
object. Calling this
constructor is equivalent to calling
|
label
- the Item
labeltext
- the text contentsStringItem(String, String, int)
public 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.BUTTON
IllegalArgumentException
- if appearanceMode
invalidMethod Detail |
public String getText()
StringItem
, or
null
if the StringItem
is
empty.setText(java.lang.String)
public void setText(String text)
StringItem
. If text
is null
,
the StringItem
is set to be empty.text
- the new contentgetText()
public int getAppearanceMode()
StringItem
.
See Appearance Modes.Item.PLAIN
, Item.HYPERLINK
, or Item.BUTTON
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
StringItem
getFont()
public 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.StringItem
setFont(javax.microedition.lcdui.Font)
public void setPreferredSize(int width, int height)
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
.
setPreferredSize
in class Item
width
- the value to which the width should be locked, or
-1
to unlockheight
- the value to which the height should be locked, or
-1
to unlockIllegalArgumentException
- if width or height is less than
-1
IllegalStateException
- if this Item
is contained
within an Alert
Item.getPreferredHeight()
,
Item.getPreferredWidth()
|
MID Profile | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |