com.nttdocomo.ui
クラス Label

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

public final class Label
extends Component

テキストを表示するコンポーネントを定義します。 ラベルクラスは、 高レベル API で使用するUI部品の一つで、文字列を表示するためのコンポーネントです。 一行テキスト表示のみをサポートします。
[DoJa-1.0]
複数行テキストを表示したい場合は、TextBox を編集不能に設定して使用します。
[DoJa-2.0]
複数行テキストを表示したい場合は編集不能のTextBoxに加え、無効状態に設定されたAnchorButtonも使用することができます。


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

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

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

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

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


フィールドの概要
static int CENTER
          ラベル文字列をセンタリングして表示することを指定します (=1)。
static int LEFT
          ラベル文字列を左寄せで表示することを指定します (=0)。
static int RIGHT
          ラベル文字列を右寄せで表示することを指定します (=2)。
 
コンストラクタの概要
Label()
          ラベル文字列が空文字列("")のラベルを生成します。
Label(java.lang.String text)
          ラベル文字列を指定してラベルを生成します。
Label(java.lang.String text, int alignment)
          ラベル文字列とアラインメントを指定してラベルを生成します。
 
メソッドの概要
 void setAlignment(int alignment)
          ラベル文字列のアラインメントを設定します。
 void setText(java.lang.String text)
          コンポーネントのラベル文字列を設定します。
 
クラス com.nttdocomo.ui.Component から継承したメソッド
getHeight, getWidth, getX, getY, setBackground, setForeground, setLocation, setSize, setVisible
 
クラス java.lang.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()
ラベル文字列が空文字列("")のラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、setVisibleメソッドを使用します。
[DoJa-2.0]
アラインメントは中央寄せが指定されたものとみなします。

Label

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

Label

public Label(java.lang.String text,
             int alignment)
ラベル文字列とアラインメントを指定してラベルを生成します。 生成時は、表示可能になっています。 表示可能、表示不能を設定するには、setVisibleメソッドを使用します。
パラメータ:
text - ラベル文字列を指定します。 nullが指定された場合は、空文字列("")が設定されます。
alignment - アラインメントを指定します。
例外:
IllegalArgumentException - 引数 alignment に不正な値が指定された場合に発生します。
メソッドの詳細

setText

public void setText(java.lang.String text)
コンポーネントのラベル文字列を設定します。
パラメータ:
text - ラベル文字列を指定します。 null が指定された場合は空文字列("")が設定されます。

setAlignment

public void setAlignment(int alignment)
ラベル文字列のアラインメントを設定します。 実際にどのように表示されるかは機種依存です。
パラメータ:
alignment - アラインメントを指定します。
例外:
IllegalArgumentException - 引数 alignment に不正な値が指定された場合に発生します。