Unofficial
"CLDC 1.1
+ MIDP 2.0"
API Reference.
(日本語版)

javax.microedition.lcdui
クラス StringItem

java.lang.Object
  上位を拡張 javax.microedition.lcdui.Item
      上位を拡張 javax.microedition.lcdui.StringItem

public class StringItem
extends Item

文字列を含むことができるアイテムです。 StringItem は表示のみです。 ユーザーは本文の編集を行えません。 ラベルおよび StringItem の本文の内容の両方をアプリケーションによって変更することができます。 ラベルの視覚的な表現は本文の表現と異なることがあります。

導入されたバージョン:
MIDP 1.0

フィールドの概要
 
クラス 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
 
コンストラクタの概要
StringItem(String label, String text)
          新しい StringItem オブジェクトを作成します。
StringItem(String label, String text, int appearanceMode)
          指定されたラベル、本文および外観モードを持つ新しい StringItem オブジェクトを作成します。
 
メソッドの概要
 int getAppearanceMode()
          StringItem の外観モードを返します。
 Font getFont()
          この StringItem をレンダリングするために使用するフォントを取得します。
 String getText()
          設定されている本文の内容を返します。
 void setFont(Font font)
          この StringItem をレンダリングする際に使用するアプリケーションが望むフォントを設定します。
 void setText(String text)
          指定された本文の内容を設定します。
 
クラス javax.microedition.lcdui.Item から継承されたメソッド
addCommand, getLabel, getLayout, getMinimumHeight, getMinimumWidth, getPreferredHeight, getPreferredWidth, notifyStateChanged, removeCommand, setDefaultCommand, setItemCommandListener, setLabel, setLayout, setPreferredSize
 
クラス java.lang.Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

StringItem

public StringItem(String label,
                  String text)

新しい StringItem オブジェクトを作成します。 このコンストラクタの呼び出しは以下の記述と等価です。

     StringItem(label, text, PLAIN);

パラメータ:
label - 設定するアイテムのラベルあるいは null を渡します。
text - 設定する本文あるいは null を渡します。

StringItem

public StringItem(String label,
                  String text,
                  int appearanceMode)

指定されたラベル、本文および外観モードを持つ新しい StringItem オブジェクトを作成します。 ラベルあるいは本文のどちらかあるいは両方は、内容を指定するか null を指定することができます。

appearanceMode パラメータ(外観モードを参照)は、アプリケーションがこの StringItem に対する意図をプラットフォームに伝えるために使用するヒントです。 アプリケーションが、ハイパーリンクやボタンのような振る舞いを提供するためには、この StringItem にデフォルト・コマンドを関連付けて、この StringItemItemCommandListener を追加すべきです。

以下に、ボタンとして StringItem を使用する例を示します。

     StringItem strItem = 
         new StringItem("Default: ", "Set",     
                        Item.BUTTON);    
     strItem.setDefaultCommand(
         new Command("Set", Command.ITEM, 1);    
     // icl is ItemCommandListener 
     strItem.setItemCommandListener(icl);

パラメータ:
label - StringItem に設定するラベル、またはラベルを設定しない場合は null を渡します。
text - StringItem に設定するテキストの内容、または内容を空にする場合は null を渡します。
appearanceMode - StringItem の外観モードを、Item.PLAINItem.HYPERLINK、または Item.BUTTON のいずれか1つを渡します。
例外:
IllegalArgumentException - appearanceMode が不適切な場合に throw します。
導入されたバージョン:
MIDP 2.0
メソッドの詳細

getText

public String getText()

設定されている本文の内容を返します。 本文が設定されていない場合は null を返します。

戻り値:
設定されている本文の内容あるいは null を返します。

setText

public void setText(String text)

指定された本文の内容を設定します。 null が指定された場合、本文の内容は設定されていない状態になります。

パラメータ:
text - 新しく設定する本文の内容あるいは null を渡します。

getAppearanceMode

public int getAppearanceMode()

StringItem の外観モードを返します。 外観モードについてはこちらを参照してください。

戻り値:
外観モードを示す Item.PLAINItem.HYPERLINK、または Item.BUTTON のうち1つの値を返します。
導入されたバージョン:
MIDP 2.0

setFont

public void setFont(Font font)

この StringItem をレンダリングする際に使用するアプリケーションが望むフォントを設定します。 フォントはヒントとして扱います。このため、実装はアプリケーションが望むフォントの指定を無視するかもしれません。

font パラメータは有効な Font オブジェクトあるいは null でなければなりません。 font パラメータが null ならば、実装は StringItem をレンダリングするためにデフォルトのフォントを使用します。

パラメータ:
font - この StringItem をレンダリングするために使用する希望のフォントを渡します。
導入されたバージョン:
MIDP 2.0
関連項目:
getFont()

getFont

public Font getFont()

この StringItem をレンダリングするために使用するフォントを取得します。 その値を実装が無視したとしても返す値はアプリケーションが設定したフォントです。 アプリケーションが全くフォントを設定しなかったか、あるいはアプリケーションが null を明示してフォントを設定した場合には、値は実装が選択したデフォルト・フォントです。

戻り値:
この StringItem をレンダリングするために使用する希望のフォントを返します。
導入されたバージョン:
MIDP 2.0
関連項目:
setFont(javax.microedition.lcdui.Font)

Unofficial
"CLDC 1.1
+ MIDP 2.0"
API Reference.
(日本語版)

公式仕様書原文の著作権表記等(※):

Mobile Information Device Profile Specification ("Specification")
Version: 2.0
Status: FCS
Release: November 5, 2002

Copyright 2002 Sun Microsystems, Inc. and Motorola, Inc.
All rights reserved.
※ただしこの API リファレンスは英語仕様を一語一句正確に翻訳したものではなく、一度私が英語の仕様原文を読んだ上で元の意味と構造をなるべく保つように書き起こしたものです。このため一部は完全に異なる説明となっています。また CLDC 1.1 部分は同仕様の範囲外であるため、まったく参考とはしていません。

※仕様書のライセンス上、問題は無いと考えておりますが、万が一問題があるとお考えの関係者の方がいらっしゃいましたらメールにて連絡をいただけると幸いに存じます(第一言語に日本語、第二言語に英語を希望しますが、返信は基本的に日本語で行います)。

この API リファレンスは仕様書の日本語版という位置づけでは作成していませんし、仕様書ほど厳格でもありません。MUST、SHOULD、MAY などの仕様の条件を強調する文を維持していません(反映すらしていない個所もあります)。仮想マシンおよび MIDP の実装のために使用することは避けてください。そのような用途には必ず公式仕様書原文そのものを用いるべきです。
この API リファレンスに記載されている内容は"さかきけい"が Sun Microsystems, Inc や Motorola, Inc、Java Community Process が公開している各種公式資料を元に、独自に調査・編集したものであり、Sun Microsystems, Inc や Motorola, Inc、Java Community Process 等とは一切関係ありません。したがってこの API リファレンスに関する問い合わせを関係各社等に対して行うことを固く禁じます。
また、記載された内容には既知か否かに関らず誤りが含まれる可能性があり、一切保証はありません。本 API リファレンスを使用した結果、不利益が生じたとしても"さかきけい"は一切の責任を負いません。
許可無く公開/非公開および Internet/Intranet/LAN を問わず他サイトに転載すること、複写および複製すること、ローカル・ファイル等に保存することを禁じます。


Copyright© 2001-2002,2005-2009,2011 by KEI SAKAKI.
ALL RIGHTS RESERVED.
無断転載を禁じます。

Unofficial "CLDC 1.0 + MIDP 1.0" API Reference はこちらです。