com.nttdocomo.ui
クラス Label

Object
  |
  +--com.nttdocomo.ui.Component
        |
        +--com.nttdocomo.ui.Label

public final class Label
extends Component

テキストを表示するコンポーネントを定義します。 ラベルクラスは、 高レベル API で使用するUI部品の一つで、文字列を表示するためのコンポーネントです。 一行テキスト表示のみをサポートします。 複数行テキストを表示したい場合は、TextBox を編集不能に設定して使用します。


[DoJa-1.0]
アラインメントを指定した場合に実際にどのように表示されるかは機種依存ですが、 概ね、以下のように表示されます。
[DoJa-2.0]
アラインメントを指定した場合は以下のように表示されます。 何も指定されない場合のアラインメントは、Label.CENTERです。

 Label.RIGHTの場合
     +----------------------+
     |                 ABCDE|
     +----------------------+

 Label.CENTERの場合
     +----------------------+
     |        ABCDE         |
     +----------------------+

 Label.LEFTの場合
     +----------------------+
     |ABCDE                 |
     +----------------------+

サイズが指定されない場合、コンポーネントのサイズは、設定されたラベル文字列が納まる最少の サイズになります。ただし、その幅がスクリーンの幅より大きくなる場合は、スクリーンに 表示できる幅になります。
[DoJa-1.0]
コンポーネントのサイズにテキストが収まらない場合の振舞は、機種依存です。
[DoJa-2.0]
コンポーネントのサイズにテキストが収まらない場合は、表示できない部分を切り捨てて表示します。

[DoJa-3.0]
ラベル文字列には通常の文字列またはXStringの文字列が指定できます。 これらは排他的に動作します。 通常の文字列が設定されている場合にXStringの文字列を設定すると、 表示される文字列はXStringの内容に置き換わります。 逆に、XStringの文字列が設定されている場合に通常の文字列を設定すると、 表示される文字列は通常の文字列の内容に置き換わります。


フィールドの概要
static int CENTER
          ラベル文字列をセンタリングして表示することを指定します (=1)。
static int LEFT
          ラベル文字列を左寄せで表示することを指定します (=0)。
static int RIGHT
          ラベル文字列を右寄せで表示することを指定します (=2)。
 
コンストラクタの概要
Label()
          ラベル文字列が空文字列("")のラベルを生成します。
Label(String text)
          ラベル文字列を指定してラベルを生成します。
Label(String text, int alignment)
          ラベル文字列とアラインメントを指定してラベルを生成します。
Label(XString xText)
           ラベル文字列にXStringの文字列を指定してラベルを生成します。
Label(XString xText, int alignment)
           XStringであるラベル文字列とアラインメントを指定してラベルを生成します。
 
メソッドの概要
 void setAlignment(int alignment)
          ラベル文字列のアラインメントを設定します。
 void setText(String text)
          コンポーネントのラベル文字列を設定します。
 void setText(XString xText)
           コンポーネントのラベル文字列をXStringで設定します。
 
クラス com.nttdocomo.ui.Component から継承したメソッド
getHeight, getWidth, getX, getY, setBackground, setFont, setForeground, setLocation, setSize, setVisible
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

LEFT

public static final int LEFT
ラベル文字列を左寄せで表示することを指定します (=0)。

関連項目:
定数フィールド値

CENTER

public static final int CENTER
ラベル文字列をセンタリングして表示することを指定します (=1)。

関連項目:
定数フィールド値

RIGHT

public static final int RIGHT
ラベル文字列を右寄せで表示することを指定します (=2)。

関連項目:
定数フィールド値
コンストラクタの詳細

Label

public Label()
ラベル文字列が空文字列("")のラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、Component.setVisible(boolean)メソッドを使用します。
[DoJa-2.0]
アラインメントは中央寄せが指定されたものとみなします。


Label

public Label(String text)
ラベル文字列を指定してラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、Component.setVisible(boolean)メソッドを使用します。
[DoJa-1.0]
ラベル文字列は、左寄せで表示されます。
[DoJa-2.0]
アラインメントは中央寄せが指定されたものとみなします。

パラメータ:
text - ラベル文字列を指定します。nullが指定された場合は、空文字列("")が設定されます。

Label

public Label(String text,
             int alignment)
ラベル文字列とアラインメントを指定してラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、Component.setVisible(boolean)メソッドを使用します。

パラメータ:
text - ラベル文字列を指定します。 nullが指定された場合は、空文字列("")が設定されます。
alignment - アラインメントを指定します。
例外:
IllegalArgumentException - 引数 alignment に不正な値が指定された場合に発生します。

Label

public Label(XString xText)
ラベル文字列にXStringの文字列を指定してラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、Component.setVisible(boolean)メソッドを使用します。
アラインメントは中央寄せが指定されたものとみなします。

パラメータ:
xText - XStringのラベル文字列を指定します。 nullが指定された場合は、空文字列("")が設定されます。
導入されたバージョン:
DoJa-3.0

Label

public Label(XString xText,
             int alignment)
XStringであるラベル文字列とアラインメントを指定してラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、Component.setVisible(boolean)メソッドを使用します。

パラメータ:
xText - XStringのラベル文字列を指定します。 nullが指定された場合は、空文字列("")が設定されます。
alignment - アラインメントを指定します。
例外:
IllegalArgumentException - 引数 alignment に不正な値が指定された場合に発生します。
導入されたバージョン:
DoJa-3.0
メソッドの詳細

setText

public void setText(String text)
コンポーネントのラベル文字列を設定します。

パラメータ:
text - ラベル文字列を指定します。 null が指定された場合は空文字列("")が設定されます。

setText

public void setText(XString xText)
コンポーネントのラベル文字列をXStringで設定します。

パラメータ:
xText - ラベル文字列を指定します。 null が指定された場合は空文字列("")が設定されます。
導入されたバージョン:
DoJa-3.0

setAlignment

public void setAlignment(int alignment)
ラベル文字列のアラインメントを設定します。 実際にどのように表示されるかは機種依存です。

パラメータ:
alignment - アラインメントを指定します。
例外:
IllegalArgumentException - 引数 alignment に不正な値が指定された場合に発生します。


NTT DoCoMo,Inc.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ(その他に許諾者がある場合は当該許諾者も含めて)の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

「iモード」、「iアプリ/アイアプリ」、「i-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。