com.nttdocomo.ui
クラス Panel

java.lang.Object
  |
  +--com.nttdocomo.ui.Frame
        |
        +--com.nttdocomo.ui.Panel

public class Panel

extends Frame

高レベルAPI のための表示面を定義します。パネル クラスは高レベル API で使用するフレームクラ スで、コンポーネントを張り付けるための親オブジェクトとなります。 パネルがスクロールするかどうか は、機種依存です。 パネルには、setTitle メソッドを呼び出すことにより、タイトルを表示させることができます。 タイトルは、 パネルの上端に表示されます。また、タイトルは、それ以外の部分と明確に区別する表示になります (反転表示や下線がつくなど)。パネルがタイトルをもつとき、パネルがスクロールするときでも、タイト ル部分はスクロールしません。

 ------+------------------+-----

   |   |Title             |Title Area

   |   +------------------+-----

 panel |                  |   |

   |   |                  |   |

   |   |                  |scrollable Area

   |   |                  |   |

   |   |                  |   |

   |   |                  |   |

 ------+------------------+-----
 

機種によりでパネルがスクロールすると定義している場合でも、 setLayoutManager のパラメータとし てnull が指定されたときに パネルのスクロール機能を無効にしてもかまいません。 無効にするかどう かは機種依存です。

関連項目:

Canvas, Dialog, FocusManager, LayoutManager, ComponentListener, SoftKeyListener, KeyListener, EventListener

クラス com.nttdocomo.ui.Frame から継承したフィールド

SOFT_KEY_1, SOFT_KEY_2

コンストラクタの概要

Panel()
空のパネルを生成します。

メソッドの概要

void	add(Component c) パネルにコンポーネントを追加します。
FocusManager	getFocusManager() パネル上のコンポーネント間のフォーカス移動を制御する フォーカス管理オブジェクトを取得 します。
void	setBackground(int c) 背景色を設定します。
void	setComponentListener(ComponentListener listener) コンポーネントリスナを登録します。
void	setFocusManager(FocusManager fm) パネル上のコンポーネント間のフォーカス移動を制御する フォーカス管理オブジェクトを設定 します。
void	setKeyListener(KeyListener listener) キーリスナを登録します。
void	setLayoutManager(LayoutManager lm) パネル上のコンポーネントの配置を制御する レイアウト管理オブジェクトを設定します。
void	setSoftKeyListener(SoftKeyListener listener) ソフトキーリスナを登録します。
void	setTitle(java.lang.String title) フレームのタイトル文字列を設定します。

クラス com.nttdocomo.ui.Frame から継承したメソッド

getHeight, getWidth, setSoftLabel

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

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

コンストラクタの詳細

Panel

public Panel()

空のパネルを生成します。

メソッドの詳細

setBackground

public void setBackground(int c)

背景色を設定します。 このメソッドが呼ばれると直ちに背景色が変更されます。デフォルトで は、機種依存の色が設定されています。

オーバーライド:

クラス Frame 内の setBackground

パラメータ:

c - 背景色を表す整数値を指定します。

例外:

java.lang.IllegalArgumentException - 引数の値が不正な場合に発生します。

setTitle

public void setTitle(java.lang.String title)

フレームのタイトル文字列を設定します。デフォルトでは空文字列("")が設定されます。

パラメータ:

title - タイトル文字列を指定します。 null を指定した場合は空文字列("")が設定されま す。

add

public void add(Component c)

パネルにコンポーネントを追加します。

パラメータ:

c - 追加するコンポーネントを指定します。

setComponentListener

public void setComponentListener(ComponentListener listener)

コンポーネントリスナを登録します。 パネルに登録できるリスナは一つだけです。 setComponentListener メソッドを複数回呼び出した場合は最後に登録したリスナだけが有 効です。 リスナオブジェクトとして null を指定するとリスナの登録を解除します。

パラメータ:

listener - 登録するリスナオブジェクトを指定します。

setSoftKeyListener

public void setSoftKeyListener(SoftKeyListener listener)

ソフトキーリスナを登録します。 パネルに登録できるリスナは一つだけです。 setSoftKeyListener メソッドを複数回呼び出した場合は最後に登録したリスナだけが有効で す。 リスナオブジェクトとして null を指定するとリスナの登録を解除します。

パラメータ:

listener - 登録するリスナオブジェクトを指定します。

setKeyListener

public void setKeyListener(KeyListener listener)

キーリスナを登録します。 パネルに登録できるリスナは一つだけです。 setKeyListener メソ ッドを複数回呼び出した場合は最後に登録したリスナだけが有効です。 リスナオブジェクトと して null を指定するとリスナの登録を解除します。

パラメータ:

listener - 登録するリスナオブジェクトを指定します。

setFocusManager

public void setFocusManager(FocusManager fm)

パネル上のコンポーネント間のフォーカス移動を制御する フォーカス管理オブジェクトを設定 します。デフォルトでは機種依存のフォーカス管理オブジェクトが設定されます。

パラメータ:

fm - フォーカス管理オブジェクトを指定します。

例外:

java.lang.IllegalArgumentException - 引数fm にnull が指定された場合に発生します。

getFocusManager

public FocusManager getFocusManager()

パネル上のコンポーネント間のフォーカス移動を制御する フォーカス管理オブジェクトを取得 します。

戻り値:

フォーカス管理オブジェクトを返します。

setLayoutManager

public void setLayoutManager(LayoutManager lm)

パネル上のコンポーネントの配置を制御する レイアウト管理オブジェクトを設定します。 デフ ォルトでは機種依存のレイアウト管理オブジェクトが設定されます。パラメータとして null を 設定すると、パネルはレイアウト管理を行いません。その場合は、アプリケーションプログラ マが全てのコンポーネントの座標を適切に 設定しなければなりません。

パラメータ:

lm - レイアウト管理オブジェクトを指定します。