com.nttdocomo.ui
クラス HTMLLayout

Object
  com.nttdocomo.ui.HTMLLayout

すべての実装インタフェース:

LayoutManager

public class HTMLLayout

extends Object

implements LayoutManager

HTML 風のレイアウトを行うレイアウトマネージャです。 基本的に Panel に add メソッドで追加した順にコンポーネントを配置しますが、 HTML の <BR> タグのように改行を指定したり、 <P> タグのように段落を指定したり、 <CENTER> タグのように配置を指定したりすることができます。 デフォルトではコンポーネントを左寄せで配置します。 最初に Panel に HTMLLayout をセットしなければなりません。

以下にコード例を示します。

   Panel p = new Panel();
   HTMLLayout lm = new HTMLLayout();
   p.setLayoutManager(lm);
   p.add(label1);
   lm.br();
   lm.begin(HTMLLayout.CENTER);
   p.add(button1);
   p.add(button2);
   lm.end();
 

レイアウトマネージャをセットするより前に Panel に add されたコンポーネントも レイアウト管理の対象となりますが、何もレイアウト指定が行われていないものとして 配置を行います。 すなわち、レイアウトマネージャをセットした直後にそれらのコンポーネントが add されたのと同じとなります。
begin 〜 end のネストは最大4段まで可能です。

どの時点で実際にレイアウトを行うかは機種依存ですが、 begin 〜 end が対になっていなかったり、begin 〜 end のネストが深かったり、 その他不正なレイアウトが指定された場合は Display.setCurrent メソッドで表示する時かそれよりも前に例外が発生します。

導入されたバージョン:

DoJa-2.0

フィールドの概要

static String	CENTER 指定した範囲で中央寄せの処理を行うことを指定する文字列です。
static String	LEFT 指定した範囲で左寄せの処理を行うことを指定する文字列です。
static String	P 指定した範囲を段落として扱うことを指定する文字列です。
static String	RIGHT 指定した範囲で右寄せの処理を行うことを指定する文字列です。

コンストラクタの概要

HTMLLayout()
HTML風のレイアウトを行うレイアウトマネージャを生成します。

メソッドの概要

void	begin(String tag) HTML の <center> 〜 </center> 等のタグの処理の 開始を指定します。
void	br() HTML の <br> タグと同様の処理をするよう指定します。
void	end() HTML の <center> 〜 </center> 等のタグの処理の 終了を指定します。

クラス Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

P

public static final String P

指定した範囲を段落として扱うことを指定する文字列です。(= "P")

LEFT

public static final String LEFT

指定した範囲で左寄せの処理を行うことを指定する文字列です。(= "LEFT")

CENTER

public static final String CENTER

指定した範囲で中央寄せの処理を行うことを指定する文字列です。(= "CENTER")

RIGHT

public static final String RIGHT

指定した範囲で右寄せの処理を行うことを指定する文字列です。(= "RIGHT")

コンストラクタの詳細

HTMLLayout

public HTMLLayout()

HTML風のレイアウトを行うレイアウトマネージャを生成します。

メソッドの詳細

br

public void br()

HTML の <br> タグと同様の処理をするよう指定します。

begin

public void begin(String tag)

HTML の <center> 〜 </center> 等のタグの処理の 開始を指定します。 必ず end メソッドと対にして使用しなければなりません。 大文字と小文字は区別しません。 サポートしていない処理を表す文字列が渡された場合は例外が発生します。

パラメータ:

tag - 処理を表す文字列を指定します。

例外:

NullPointerException - [DoJa-3.0 (505i) 以降] 引数 tag が null の場合に発生します。

IllegalArgumentException - 引数 tag にサポートしていない処理を表す文字列が指定された場合に発生します。

UIException - [DoJa-3.0 (505i) 以降] begin〜endのネストが実装の限界を超えた場合に発生します (ILLEGAL_STATE)。

end

public void end()

HTML の <center> 〜 </center> 等のタグの処理の 終了を指定します。 必ず begin メソッドと対にして使用しなければなりません。

例外:

UIException - 対応する begin が無い場合に発生します(ILLEGAL_STATE)。