概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし
概要:  内部クラス | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

com.nttdocomo.ui
クラス ListBox

java.lang.Object
  |
  +--com.nttdocomo.ui.Component
        |
        +--com.nttdocomo.ui.ListBox
すべての実装インタフェース:
Interactable
public final class ListBox
extends Component
implements Interactable

リストボックスコンポーネント クラスです。高レベル API で使用するUI 部品の一つで、選択リスト、チ ェックボックス、ラジオボタンを 表すコンポーネントです。 コンストラクタの引数でリストのタイプを指定することにより、以下のリストが作成できます。

形状と選択の種類の観点からまとめると以下のようになります。

形状選択
単一選択複数選択
ポップアップ形式オプションメニュー(CHOICE)なし
フィールド形式リストシングル選択リスト(SINGLE_SELECT)複数選択リスト(MULTIPLE_SELECT)
番号つきリスト番号つきリスト(NUMBERED_LIST)なし
チェックボックスなしチェックボックスリスト(CHECK_BOX)
ラジオボタンラジオボタンリスト(RADIO_BUTTON)なし
　　
オプションメニューは、CHTML のSELECT タグでサイズ指定をしない場合のメニューに相当します。 通 常は、選択されている項目が表示されており、そのリストコンポーネントが選択されると、リスト中の項 目が展開されて表示されます。 

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

    | item1     |  ---->  |item1      |

    +-----------+  <----  |item2      |

                          |item3      |

                          +-----------+
展開されたときのメニューの高さは格納されている項目が表示できる高さとスクリーンの高さのうちの 小さい方のサイズになります。したがって、項目が多い場合、展開表示されて1 度に表示する項目の数 は 制限されますが、この表示中でスクロールすることにより隠れていた項目を表示することができま す。 また、展開されたときのメニューの幅は機種依存です。 フィールド形式のリストは、ボックス型のスクロールドリストです。サイズ指定がない場合、 この形式の リストは、リストの幅がパネルの幅と等しくなり、高さは、登録されている項目数が表示できる高さと ス クリーンの高さのうちの小さい方になります。なお、行数が指定されている場合は、高さは、その行数を 表示できる高さと スクリーンの高さのうちの小さい方になります。行数に0 が指定されている場合は、1 が指定されていると見なします。 項目数が多く、すべてを表示できない場合は、スクロールすることに より、隠れていた項目を表示することができます。 表示例を以下に示します。 
    +------------+   +------------+   +------------+   +------------+

    |item1       |   |1. item1    |   |○ item1    |   |□ item1    |

    |item2       |   |2. item2    |   |○ item2    |   |■ item2    |

    |item3       |   |3. item3    |   |◎ item3    |   |□ item3    | 

    |item4       |   |4. item4    |   |○ item4    |   |□ item4    |

    |item5       |   |5. item5    |   |○ item5    |   |■ item5    |

    +------------+   +------------+   +------------+   +------------+
番号つきリストは、シングル選択リストの特殊なもので、先頭から9 個が数字キーで選択できます。 先 頭が、1 キー、2 番目が、2 キーと順に対応づけられ、9 番目が9 キーに対応します。1 0 番目以降の 項 目にはキーが対応づけられません。1 0 番目以降は、シングル選択リストと同じ操作で選択します。 設定する項目の文字列がコンポーネントの幅より長い場合の振舞(切り縮めるか折り返すかなど)は、 機種依存です。 項目数が多く、指定されたサイズですべての項目が表示できない場合は、項目をスク ロールして表示します。 リストのインデックスは、先頭の項目を指定する場合に0 を、二番目の項目を指定する場合に1 を、 と いうように指定します。

フィールドの概要
static int CHECK_BOX
          項目のそれぞれについて選択/非選択を指定できるチェックボックスです (=2)。
static int CHOICE
          オプションメニューです (=5)。
static int MULTIPLE_SELECT
          項目を複数選択できるリスト(複数選択リスト)です (=4)。
static int NUMBERED_LIST
          項目に番号が割り当てられていて、番号に対応するキーを押すことで直接その項目を選択で きる番号付きリストです (=3)。
static int RADIO_BUTTON
          複数の項目から一つだけを排他的に選択できるラジオボタンです (=1)。
static int SINGLE_SELECT
          項目を一つだけ選択できるリスト(シングル選択リスト)です (=0)。
 
コンストラクタの概要
ListBox(int type)
          項目を持たない空のリストボックスを生成します。
ListBox(int type, int rows)
          項目を持たない空のリストボックスを生成します。
 
メソッドの概要
 void append(java.lang.String item)
          リストの末尾に項目を追加します。
 void deselect(int index)
          リストの特定の位置の項目を選択解除します。
 java.lang.String getItem(int index)
          リストの特定の位置の項目を取得します。
 int getItemCount()
          リストの項目の数を取得します。
 int getSelectedIndex()
          選択されている項目の位置を返します。
 boolean isIndexSelected(int index)
          リストの特定の位置の項目が選択されているかどうか調べます。
 void removeAll()
          リストの全ての項目を削除します。
 void requestFocus()
          リストボックスにフォーカスをセットするよう要求します。
 void select(int index)
          リストの特定の位置の項目を選択します。
 void setEnabled(boolean b)
          リストボックスをユーザ操作可能にしたりユーザ操作不能にしたりします。
 void setItems(java.lang.String[] items)
          リストの項目をまとめて配列で設定します。
 
クラス 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
 

フィールドの詳細

SINGLE_SELECT

public static final int SINGLE_SELECT
項目を一つだけ選択できるリスト(シングル選択リスト)です (=0)。

RADIO_BUTTON

public static final int RADIO_BUTTON
複数の項目から一つだけを排他的に選択できるラジオボタンです (=1)。

CHECK_BOX

public static final int CHECK_BOX
項目のそれぞれについて選択/非選択を指定できるチェックボックスです (=2)。

NUMBERED_LIST

public static final int NUMBERED_LIST
項目に番号が割り当てられていて、番号に対応するキーを押すことで直接その項目を選択で きる番号付きリストです (=3)。

MULTIPLE_SELECT

public static final int MULTIPLE_SELECT
項目を複数選択できるリスト(複数選択リスト)です (=4)。

CHOICE

public static final int CHOICE
オプションメニューです (=5)。
コンストラクタの詳細

ListBox

public ListBox(int type)
項目を持たない空のリストボックスを生成します。生成時は、表示可能で、ユーザ操作可能 になっています。表示可能、表示不能を設定するには、setVisible メソッドを使用します。 ユ ーザ操作可能、ユーザ操作不能を設定するには、setEnabled メソッドを使用します。
パラメータ:
type - リストボックスのタイプを指定します。type には、 SINGLE_SELECT 、 RADIO_BUTTON 、CHECK_BOX 、NUMBERED_LIST 、MULTIPLE_SELECT 、 CHOICE のいずれかが指定できます。それ以外の値を指定した場合は、例外が発生します。
例外:
java.lang.IllegalArgumentException - タイプ指定が不正な場合に発生します。

ListBox

public ListBox(int type,
               int rows)
項目を持たない空のリストボックスを生成します。 生成時は、表示可能で、ユーザ操作可能 になっています。表示可能、表示不能を設定するには、setVisible メソッドを使用します。 ユ ーザ操作可能、ユーザ操作不能を設定するには、setEnabled メソッドを使用します。
パラメータ:
type - リストボックスのタイプを指定します。type には、 SINGLE_SELECT 、 RADIO_BUTTON 、CHECK_BOX 、NUMBERED_LIST 、MULTIPLE_SELECT 、 CHOICE のいずれかが指定できます。それ以外の値を指定した場合は、例外が発生しま す。
rows - 表示する行数を指定します。このパラメータは、タイプが CHOICE 以外の場合に有 効です。 0 が指定された場合は、1 が指定されたものとして振舞います。
例外:
java.lang.IllegalArgumentException - タイプ指定が不正な場合またはrows に0 未満の数が 設定さ れたときに発生します。
メソッドの詳細

setEnabled

public void setEnabled(boolean b)
リストボックスをユーザ操作可能にしたりユーザ操作不能にしたりします。デフォルトではユ ーザ操作可能です。
定義:
インタフェース Interactable 内の setEnabled
パラメータ:
b - ユーザ操作可能にする場合は true を、ユーザ操作不能にする場合は false を指定し ます。

requestFocus

public void requestFocus()
リストボックスにフォーカスをセットするよう要求します。 リストボックスをadd メソッドでパネル に追加される以前に発行された 要求は無視されます。 ユーザ操作不能になっている場合、 requestFocus()によるフォーカスリクエストは 受け付けられません。
定義:
インタフェース Interactable 内の requestFocus

setItems

public void setItems(java.lang.String[] items)
リストの項目をまとめて配列で設定します。それまでの項目は全て削除され、指定された配 列の項目が全て設定されます。 ユーザ操作可能／不能に関わらず、このメソッドは機能します。
パラメータ:
item - 追加する項目を指定します。 null が指定された場合は NullPointerException が発生します。
例外:
NullPointerException - 引数にnull が指定された場合に発生します。

append

public void append(java.lang.String item)
リストの末尾に項目を追加します。 ユーザ操作可能/不能に関わらず、このメソッドは機能しま す。
パラメータ:
item - 追加する項目を指定します。 null が指定された場合は NullPointerException が 発生します。
例外:
NullPointerException - 引数にnull が指定された場合に発生します。

removeAll

public void removeAll()
リストの全ての項目を削除します。ユーザ操作可能/不能に関わらず、このメソッドは機能しま す。

getItemCount

public int getItemCount()
リストの項目の数を取得します。
戻り値:
リストの項目の数を返します。

getItem

public java.lang.String getItem(int index)
リストの特定の位置の項目を取得します。
パラメータ:
index - 取得する項目の位置を指定します。
戻り値:
指定された位置の項目を返します。

select

public void select(int index)
リストの特定の位置の項目を選択します。その項目が表示されていない位置にある場合は、 その項目 が表示される位置までスクロールします。 項目を選択すると、リストボックスのタイ プに応じてコンポーネントイベント(SELECTION_CHANGED)が発生します。 不可視、可視に関わらず、このメソッドの呼び出しにより、選択状態は変更されます。だだし、 イベントは、 可視の場合だけ発生します。 ユーザ操作可能/不能に関わらず、このメソッドは機能します。
パラメータ:
index - 選択する項目の位置を指定します。

deselect

public void deselect(int index)
リストの特定の位置の項目を選択解除します。 項目を選択解除すると、リストボックスのタイ プに応じてコンポーネントイベント(SELECTION_CHANGED)が発生します。 不可視、可視に関わらず、このメソッドの呼び出しにより、選択状態は変更されます。ただし、 イベントは、可視の場合だけ発生します。 ユーザの操作可能／不能に関わらず、このメソッドは機能します。
パラメータ:
index - 選択解除する項目の位置を指定します。

isIndexSelected

public boolean isIndexSelected(int index)
リストの特定の位置の項目が選択されているかどうか調べます。
パラメータ:
index - 選択されているかどうか調べる項目の位置を指定します。
戻り値:
項目が選択されている場合は true を、そうでない場合は false を返します。

getSelectedIndex

public int getSelectedIndex()
選択されている項目の位置を返します。 複数選択されている場合は、位置の値が最も小さい 項目の位置を返します。なお、選択されていない場合は、-1 を返します。
戻り値:
選択されている項目の位置。 選択されていない場合は、-1 を返します。
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし
概要:  内部クラス | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

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

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

「i-mode／アイモード」はNTTドコモの登録商標、「ｉアプリ／ｉαppli／アイアプリ」はNTTドコモの商標です。