|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Choice
Choice
クラスは選択のポップアップメニューを表します。現在の選択は、メニューのタイトルとして表示されます。
次のコード例は、ポップアップメニューを作成します。
Choice ColorChooser = new Choice(); ColorChooser.add("Green"); ColorChooser.add("Red"); ColorChooser.add("Blue");
この選択メニューは、パネルに追加されたあとで、次のように、通常の状態で表示されます。
この図では "Green"
が現在の選択です。オブジェクト上でマウスボタンを押すと、現在の選択がハイライトされた状態でメニューが表示されます。
ネイティブなプラットフォームには、Choice コンポーネントの任意のサイズ変更をサポートしていないものがあり、setSize() または getSize() の動作はこうした制限と結び付いています。ネイティブな GUI Choice コンポーネントのサイズは、Choice 内に含まれる項目のフォントサイズや長さなどの属性と結び付いている場合がよくあります。
内部クラスの概要 | |
protected class |
Choice.AccessibleAWTChoice
このクラスは Choice クラス用のユーザ補助機能のサポートを実装しています。 |
クラス java.awt.Component から継承した内部クラス |
Component.AccessibleAWTComponent |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
インタフェース java.awt.image.ImageObserver から継承したフィールド |
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
コンストラクタの概要 | |
Choice()
新しい選択メニューを作成します。 |
メソッドの概要 | |
void |
add(String item)
この Choice メニューに項目を追加します。 |
void |
addItem(String item)
この Choice に項目を追加します。 |
void |
addItemListener(ItemListener l)
この Choice メニューから項目イベントを受け取れるように、指定された項目リスナーを追加します。 |
void |
addNotify()
Choice のピアを作成します。 |
int |
countItems()
推奨されていません。 JDK バージョン 1.1 以降は、 getItemCount() に置き換えられました |
AccessibleContext |
getAccessibleContext()
この Choice に関連した AccessibleContext を返します。 |
String |
getItem(int index)
この Choice メニュー内の指定されたインデックスの文字列を返します。 |
int |
getItemCount()
この Choice メニュー内の項目数を返します。 |
EventListener[] |
getListeners(Class listenerType)
addXXXListener() を持つ Choice に追加された全リスナーの配列を返します。 |
int |
getSelectedIndex()
現在選択されている項目のインデックスを返します。 |
String |
getSelectedItem()
現在選択されている文字列表現を返します。 |
Object[] |
getSelectedObjects()
現在選択されている項目を含む配列 (長さが 1) を返します。 |
void |
insert(String item,
int index)
この Choice の指定された位置に項目を挿入します。 |
protected String |
paramString()
この選択メニューの状態を表すパラメータ文字列を返します。 |
protected void |
processEvent(AWTEvent e)
この Choice のイベントを処理します。 |
protected void |
processItemEvent(ItemEvent e)
この Choice メニューで発生する項目イベントを、登録されているすべての ItemListener オブジェクトにディスパッチすることにより、項目イベントを処理します。
|
void |
remove(int position)
選択メニューから、指定された位置にある項目を削除します。 |
void |
remove(String item)
Choice メニューから最初の item を削除します。 |
void |
removeAll()
選択メニューからすべての項目を削除します。 |
void |
removeItemListener(ItemListener l)
この Choice メニューから項目イベントを受け取らないように、指定された項目リスナーを削除します。 |
void |
select(int pos)
この Choice メニューの選択項目を、指定された位置にある項目に設定します。 |
void |
select(String str)
この Choice メニューの選択項目を、指定された文字列と名前が同じである項目に設定します。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
コンストラクタの詳細 |
public Choice()
デフォルトでは、select
メソッドを呼び出すことによってユーザが別の選択を行うまで、選択メニューに追加された最初の項目が選択項目になります。
select(int)
,
select(java.lang.String)
メソッドの詳細 |
public void addNotify()
Component
内の addNotify
Toolkit.createChoice(java.awt.Choice)
,
Component.getToolkit()
public int getItemCount()
Choice
メニュー内の項目数を返します。getItem(int)
public int countItems()
getItemCount()
に置き換えられました
public String getItem(int index)
Choice
メニュー内の指定されたインデックスの文字列を返します。index
- 開始を示すインデックスgetItemCount()
public void add(String item)
Choice
メニューに項目を追加します。item
- 追加される項目NullPointerException
- 項目の値が null
の場合public void addItem(String item)
item
- 追加される項目NullPointerException
- その項目の値が null に等しい場合public void insert(String item, int index)
item
- 挿入される項目index
- 項目が挿入される位置IllegalArgumentException
- インデックスが 0 より小さい場合public void remove(String item)
Choice
メニューから最初の item
を削除します。item
- この Choice
メニューから削除される項目IllegalArgumentException
- 選択メニューに項目がない場合public void remove(int position)
position
- 項目の位置public void removeAll()
remove(java.lang.String)
public String getSelectedItem()
getSelectedIndex()
public Object[] getSelectedObjects()
ItemSelectable
内の getSelectedObjects
ItemSelectable
public int getSelectedIndex()
getSelectedItem()
public void select(int pos)
Choice
メニューの選択項目を、指定された位置にある項目に設定します。pos
- 選択項目の位置IllegalArgumentException
- 指定された位置が無効な場合getSelectedItem()
,
getSelectedIndex()
public void select(String str)
Choice
メニューの選択項目を、指定された文字列と名前が同じである項目に設定します。指定された文字列に一致する項目が複数ある場合は、インデックス値がもっとも小さい項目が選択されます。str
- 指定された文字列getSelectedItem()
,
getSelectedIndex()
public void addItemListener(ItemListener l)
Choice
メニューから項目イベントを受け取れるように、指定された項目リスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。ItemSelectable
内の addItemListener
l
- 項目リスナーItemEvent
,
ItemListener
,
removeItemListener(java.awt.event.ItemListener)
public void removeItemListener(ItemListener l)
Choice
メニューから項目イベントを受け取らないように、指定された項目リスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。ItemSelectable
内の removeItemListener
l
- 項目リスナーItemEvent
,
ItemListener
,
addItemListener(java.awt.event.ItemListener)
public EventListener[] getListeners(Class listenerType)
listenerType
の引数の名前です。たとえば、指定された Choice c
の ItemListener(s) をすべて取得するには、次のように記述します。
ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class))該当するリスナーリストが存在しない場合は、空の配列が返されます。
Component
内の getListeners
listenerType
- 要求されたリスナーのタイプprotected void processEvent(AWTEvent e)
ItemEvent
のインスタンスである場合は、processItemEvent
メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent
メソッドを呼び出します。Component
内の processEvent
e
- イベントItemEvent
,
processItemEvent(java.awt.event.ItemEvent)
protected void processItemEvent(ItemEvent e)
Choice
メニューで発生する項目イベントを、登録されているすべての ItemListener
オブジェクトにディスパッチすることにより、項目イベントを処理します。
項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。項目イベントは、以下の項目の 1 つが発生したときに使用可能になります。
ItemListener
オブジェクトが addItemListener
により登録されている
enableEvents
によって項目イベントが使用可能になっている
e
- 項目イベントItemEvent
,
ItemListener
,
addItemListener(java.awt.event.ItemListener)
,
Component.enableEvents(long)
protected String paramString()
Component
内の paramString
Choice
メニューのパラメータ文字列public AccessibleContext getAccessibleContext()
Accessible
内の getAccessibleContext
Component
内の getAccessibleContext
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.