com.docomostar.ui
クラス Panel

Object
  上位を拡張 com.docomostar.ui.Frame
      上位を拡張 com.docomostar.ui.Panel

public class Panel
extends Frame

高レベルAPIのための表示面を定義します。 パネル クラスは高レベル API で使用するフレームクラスで、 コンポーネントを張り付けるための親オブジェクトとなります。

コンポーネントが一画面に収まらない場合は、ユーザのキー操作にともなってスクロールします。

パネルには、setTitleメソッドを呼び出すことにより、タイトルを表示させることができます。 タイトルは、パネルの上端に表示されます。また、 タイトルは、それ以外の部分と明確に区別する表示になります(反転表示や下線がつくなど)。 パネルがタイトルをもつとき、パネルがスクロールするときでも、タイトル部分はスクロールしません。

 ------+------------------+-----
   |   |  Title           | Title Area
   |   +------------------+-----
 panel |                  |   | 
   |   |                  |   |
   |   |                  |scrollable Area
   |   |                  |   |
   |   |                  |   |
   |   |                  |   |
 ------+------------------+-----

導入されたバージョン:
Star-1.0
関連項目:
Canvas, Dialog, FocusManager, LayoutManager, ComponentListener, SoftKeyListener, KeyListener, EventListener

フィールドの概要
 
クラス com.docomostar.ui.Frame から継承されたフィールド
ARROW_DOWN, ARROW_LEFT, ARROW_RIGHT, ARROW_UP, SELECT_KEY, SOFT_KEY_1, SOFT_KEY_2, SOFT_KEY_3, SOFT_KEY_4
 
コンストラクタの概要
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 setSoftArrowLabel(int key)
          上下左右キーの上下左右矢印の表示を設定します。
 void setSoftKeyListener(SoftKeyListener listener)
          ファンクションキーリスナを登録します。
 void setSoftLabelVisible(boolean b) [iアプリオプションAPI]
          ファンクションキーを表示するかどうかを設定します。
 void setTitle(String title)
          フレームのタイトル文字列を設定します。
 
クラス com.docomostar.ui.Frame から継承されたメソッド
getHeight, getWidth, setSoftLabel
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

Panel

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

メソッドの詳細

setBackground

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

オーバーライド:
クラス Frame 内の setBackground
パラメータ:
c - 背景色を表す整数値を指定します。
関連項目:
Graphics.clearRect(int, int, int, int)
例外:
IllegalArgumentException -
引数 c に不正な値が指定された場合に発生します。

setTitle

public void setTitle(String title)
フレームのタイトル文字列を設定します。

デフォルトではタイトル文字列は表示されません。

引数 title に null を指定した場合はタイトル文字列の表示領域を消去します。 空文字列("")を指定した場合は、 タイトル文字列の表示領域は現れますが文字列は何も表示されません。

パラメータ:
title - タイトル文字列を指定します。

add

public void add(Component c)
パネルにコンポーネントを追加します。

パラメータ:
c - 追加するコンポーネントを指定します。
例外:
UIException -
(NO_RESOURCES)
端末がサポートしている以上の数コンポーネントを add しようとした場合に発生します。
NullPointerException -
引数 c に null が指定された場合に発生します。
UIException -
(ILLEGAL_STATE)
既に他の Panel に add されているコンポーネントを add しようとした場合に発生します。

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 - フォーカス管理オブジェクトを指定します。
例外:
NullPointerException -
引数 fm に null が指定された場合に発生します。
IllegalArgumentException -
引数fmにシステムが提供している以外のフォーカスマネージャ (FocusManagerインタフェースを実装した未知のクラスのオブジェクト) が指定された場合に発生します。

getFocusManager

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

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

setLayoutManager

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

パラメータ:
lm - レイアウト管理オブジェクトを指定します。
例外:
IllegalArgumentException -
引数lmにシステムが提供している以外のレイアウトマネージャ (LayoutManagerインタフェースを実装した未知のクラスのオブジェクト) が指定された場合に発生します。

setSoftLabelVisible

public void setSoftLabelVisible(boolean b) [iアプリオプションAPI]
ファンクションキーを表示するかどうかを設定します。

パネルクラスでは、 ファンクションキーの表示・非表示を設定できないので、 このクラスでは、オーバライドにより機能を止めています。したがって、 このメソッドを呼び出した場合、常に UnsupportedOperationException 例外が発生します。

オーバーライド:
クラス Frame 内の setSoftLabelVisible
パラメータ:
b - 指定に意味を持ちません。
例外:
UnsupportedOperationException -
このメソッドが呼ばれた場合に発生します。

setSoftArrowLabel

public void setSoftArrowLabel(int key)
上下左右キーの上下左右矢印の表示を設定します。

パネルクラスでは、上下左右矢印の表示を設定できないので、 このクラスでは、オーバライドにより機能を止めています。したがって、 このメソッドを呼び出した場合、常に UnsupportedOperationException 例外が発生します。

オーバーライド:
クラス Frame 内の setSoftArrowLabel
パラメータ:
key - 指定に意味を持ちません。
例外:
UnsupportedOperationException -
このメソッドが呼ばれた場合に発生します。


NTT DOCOMO,INC.

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

Sun、Sun MiCLASS="NavBarFont1Rev">繧ッ繝ゥ繧ケ  髫主ア、繝