java.awt
クラス Choice

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Choice

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

Accessible, ImageObserver, ItemSelectable, MenuContainer, Serializable

public class Choice

extends Component

implements ItemSelectable, Accessible

Choice クラスは選択のポップアップメニューを表します。現在の選択は、メニューのタイトルとして表示されます。

次のコード例は、ポップアップメニューを作成します。

 Choice ColorChooser = new Choice();
 ColorChooser.add("Green");
 ColorChooser.add("Red");
 ColorChooser.add("Blue");

この選択メニューは、パネルに追加されたあとで、次のように、通常の状態で表示されます。

この図では "Green" が現在の選択です。オブジェクト上でマウスボタンを押すと、現在の選択がハイライトされた状態でメニューが表示されます。

ネイティブなプラットフォームには、Choice コンポーネントの任意のサイズ変更をサポートしていないものがあり、setSize() または getSize() の動作はこうした制限と結び付いています。ネイティブな GUI Choice コンポーネントのサイズは、Choice 内に含まれる項目のフォントサイズや長さなどの属性と結び付いている場合がよくあります。

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

内部クラスの概要

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.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getName, getParent, getPeer, getPreferredSize, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFont, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, update, validate

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

Choice

public Choice()

新しい選択メニューを作成します。初期状態では、メニューには項目がありません。

デフォルトでは、select メソッドを呼び出すことによってユーザが別の選択を行うまで、選択メニューに追加された最初の項目が選択項目になります。

関連項目:

select(int), select(java.lang.String)

メソッドの詳細

addNotify

public void addNotify()

Choice のピアを作成します。このピアにより Choice の機能を変更せずにその外観を変更することができます。

オーバーライド:

クラス Component 内の addNotify

関連項目:

Toolkit.createChoice(java.awt.Choice), Component.getToolkit()

getItemCount

public int getItemCount()

この Choice メニュー内の項目数を返します。

導入されたバージョン:

JDK1.1

関連項目:

getItem(int)

countItems

public int countItems()

推奨されていません。 JDK バージョン 1.1 以降は、getItemCount() に置き換えられました

getItem

public String getItem(int index)

この Choice メニュー内の指定されたインデックスの文字列を返します。

パラメータ:

index - 開始を示すインデックス

関連項目:

getItemCount()

add

public void add(String item)

この Choice メニューに項目を追加します。

パラメータ:

item - 追加される項目

例外:

NullPointerException - 項目の値が null の場合

導入されたバージョン:

JDK1.1

addItem

public void addItem(String item)

この Choice に項目を追加します。

パラメータ:

item - 追加される項目

例外:

NullPointerException - その項目の値が null に等しい場合

insert

public void insert(String item,
                   int index)

この Choice の指定された位置に項目を挿入します。

パラメータ:

item - 挿入される項目

index - 項目が挿入される位置

例外:

IllegalArgumentException - インデックスが 0 より小さい場合

remove

public void remove(String item)

Choice メニューから最初の item を削除します。

パラメータ:

item - この Choice メニューから削除される項目

例外:

IllegalArgumentException - 選択メニューに項目がない場合

導入されたバージョン:

JDK1.1

remove

public void remove(int position)

選択メニューから、指定された位置にある項目を削除します。

パラメータ:

position - 項目の位置

導入されたバージョン:

JDK1.1

removeAll

public void removeAll()

選択メニューからすべての項目を削除します。

導入されたバージョン:

JDK1.1

関連項目:

remove(java.lang.String)

getSelectedItem

public String getSelectedItem()

現在選択されている文字列表現を返します。

戻り値:

この選択メニューでの現在の選択項目の文字列表現

関連項目:

getSelectedIndex()

getSelectedObjects

public Object[] getSelectedObjects()

現在選択されている項目を含む配列 (長さが 1) を返します。選択されている項目がない場合は、null を返します。

定義:

インタフェース ItemSelectable 内の getSelectedObjects

関連項目:

ItemSelectable

getSelectedIndex

public int getSelectedIndex()

現在選択されている項目のインデックスを返します。

関連項目:

getSelectedItem()

select

public void select(int pos)

この Choice メニューの選択項目を、指定された位置にある項目に設定します。

パラメータ:

pos - 選択項目の位置

例外:

IllegalArgumentException - 指定された位置が無効な場合

関連項目:

getSelectedItem(), getSelectedIndex()

select

public void select(String str)

この Choice メニューの選択項目を、指定された文字列と名前が同じである項目に設定します。指定された文字列に一致する項目が複数ある場合は、インデックス値がもっとも小さい項目が選択されます。

パラメータ:

str - 指定された文字列

関連項目:

getSelectedItem(), getSelectedIndex()

addItemListener

public void addItemListener(ItemListener l)

この Choice メニューから項目イベントを受け取れるように、指定された項目リスナーを追加します。l が null の場合、例外はスローされず、処理も実行されません。

定義:

インタフェース ItemSelectable 内の addItemListener

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, removeItemListener(java.awt.event.ItemListener)

removeItemListener

public void removeItemListener(ItemListener l)

この Choice メニューから項目イベントを受け取らないように、指定された項目リスナーを削除します。l が null の場合、例外はスローされず、処理も実行されません。

定義:

インタフェース ItemSelectable 内の removeItemListener

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener)

getListeners

public EventListener[] getListeners(Class listenerType)

addXXXListener() を持つ Choice に追加された全リスナーの配列を返します。XXX は listenerType の引数の名前です。たとえば、指定された Choice c の ItemListener(s) をすべて取得するには、次のように記述します。

 ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class))

該当するリスナーリストが存在しない場合は、空の配列が返されます。

オーバーライド:

クラス Component 内の getListeners

パラメータ:

listenerType - 要求されたリスナーのタイプ

戻り値:

この選択によってサポートされる、指定されたタイプのすべてのリスナー

導入されたバージョン:

1.3

processEvent

protected void processEvent(AWTEvent e)

この Choice のイベントを処理します。イベントが ItemEvent のインスタンスである場合は、processItemEvent メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent メソッドを呼び出します。

オーバーライド:

クラス Component 内の processEvent

パラメータ:

e - イベント

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

この Choice メニューで発生する項目イベントを、登録されているすべての ItemListener オブジェクトにディスパッチすることにより、項目イベントを処理します。

項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。項目イベントは、以下の項目の 1 つが発生したときに使用可能になります。

• ItemListener オブジェクトが addItemListener により登録されている
• enableEvents によって項目イベントが使用可能になっている

パラメータ:

e - 項目イベント

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

この選択メニューの状態を表すパラメータ文字列を返します。この文字列はデバッグの際に便利です。

オーバーライド:

クラス Component 内の paramString

戻り値:

この Choice メニューのパラメータ文字列

getAccessibleContext

public AccessibleContext getAccessibleContext()

この Choice に関連した AccessibleContext を返します。Choice コンポーネントの場合、AccessibleContext は AccessibleAWTChoice の形式を取ります。必要に応じて新しい AccessibleAWTChoice インスタンスを作成します。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

この Choice の AccessibleContext として機能する AccessibleAWTChoice