java.awt
クラス Choice

java.lang.Object
  java.awt.Component
      java.awt.Choice

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

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible

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, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

クラス 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) Java 2 プラットフォーム v1.1 では使用しません。
void	addItemListener(ItemListener l) 指定された項目リスナーを、この Choice メニューの項目イベント受信のために追加します。
void	addNotify() Choice のピアを生成します。
int	countItems() 推奨されていません。 JDK Version 1.1 以降は、getItemCount() に置き換えられました。
AccessibleContext	getAccessibleContext() この Choice に関連付けられる AccessibleContext を取得します。
String	getItem(int index) この Choice メニュー内の指定されたインデックスの文字列を返します。
int	getItemCount() この Choice メニュー内の項目数を返します。
ItemListener[]	getItemListeners() この選択範囲に登録されているすべての項目リスナーの配列を返します。
<T extends EventListener> T[]	getListeners(Class<T> listenerType) この Choice に FooListener として現在登録されているすべてのオブジェクトの配列を返します。
int	getSelectedIndex() 現在選択されている項目のインデックスを返します。
String	getSelectedItem() 現在選択されている文字列表現を返します。
Object[]	getSelectedObjects() 現在選択されている項目を含む配列 (長さ 1) を返します。
void	insert(String item, int index) この Choice の指定された位置に項目を挿入します。
protected String	paramString() この Choice メニューの状態を表す文字列を返します。
protected void	processEvent(AWTEvent e) この Choice のイベントを処理します。
protected void	processItemEvent(ItemEvent e) この Choice メニューで発生する項目イベントを、登録されているすべての ItemListener オブジェクトにディスパッチすることにより、項目イベントを処理します。
void	remove(int position) 選択メニューから、指定された位置にある項目を削除します。
void	remove(String item) item の最初に表示される項目を Choice メニューから削除します。
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, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, 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, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

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

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

コンストラクタの詳細

Choice

public Choice()
       throws HeadlessException

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

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

例外:

HeadlessException - GraphicsEnvironment.isHeadless() が true を返す場合

関連項目:

GraphicsEnvironment.isHeadless(), 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 メニュー内の項目数を返します。

戻り値:

この Choice メニュー内の項目数

導入されたバージョン:

JDK1.1

関連項目:

getItem(int)

countItems

@Deprecated
public int countItems()

推奨されていません。 JDK Version 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)

Java 2 プラットフォーム v1.1 では使用しません。代わりに add メソッドを使用してください。

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

パラメータ:

item - 追加される項目

例外:

NullPointerException - その項目の値が null の場合

insert

public void insert(String item,
                   int index)

この Choice の指定された位置に項目を挿入します。index 以降の項目は 1 つずつ後に移動されます。index の値がこの選択範囲の項目数以上の場合、item はこの選択範囲の最後に追加されます。

項目が選択範囲に追加される最初の項目である場合、この項目が選択されます。最初の項目でない場合、選択される項目が移動される項目の場合は、選択範囲の最初の項目が選択されます。移動される項目でない場合は、その項目がそのまま選択されます。 挿入される項目。

パラメータ:

item - 挿入される項目。null は指定不可

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

例外:

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

remove

public void remove(String item)

item の最初に表示される項目を Choice メニューから削除します。現在選択されている項目が削除対象の場合、選択範囲の最初の項目が選択項目になります。削除対象になっていない場合、現在の項目がそのまま選択されます (選択されたインデックスが必要に応じて更新されます)。

パラメータ:

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

例外:

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

導入されたバージョン:

JDK1.1

remove

public void remove(int position)

選択メニューから、指定された位置にある項目を削除します。現在選択されている項目が削除対象の場合、選択範囲の最初の項目が選択項目になります。削除対象になっていない場合、現在の項目がそのまま選択されます (選択されたインデックスが必要に応じて更新されます)。

パラメータ:

position - 項目の位置

例外:

IndexOutOfBoundsException - 指定された位置が範囲外である場合

導入されたバージョン:

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()

現在選択されている項目のインデックスを返します。何も選択されていない場合は -1 を返します。

戻り値:

現在選択されている項目のインデックス、または何も選択されていない場合は -1

関連項目:

getSelectedItem()

select

public void select(int pos)

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

このメソッドは、主にこのコンポーネント内の項目を初期状態で選択するために使用されます。このメソッドをプログラムによって呼び出す場合は、ItemEvent をトリガーしません。ItemEvent をトリガーする唯一の方法はユーザーの操作です。

パラメータ:

pos - 選択項目の位置

例外:

IllegalArgumentException - 指定された位置が項目の数より大きいか、ゼロより小さい場合

関連項目:

getSelectedItem(), getSelectedIndex()

select

public void select(String str)

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

このメソッドは、主にこのコンポーネント内の項目を初期状態で選択するために使用されます。このメソッドをプログラムによって呼び出す場合は、ItemEvent をトリガーしません。ItemEvent をトリガーする唯一の方法はユーザーの操作です。

パラメータ:

str - 指定された文字列

関連項目:

getSelectedItem(), getSelectedIndex()

addItemListener

public void addItemListener(ItemListener l)

指定された項目リスナーを、この Choice メニューの項目イベント受信のために追加します。項目イベントは select の呼び出しではなく、ユーザーの入力に反応してリスナーに送信されます。l が null の場合、例外はスローされず、処理も実行されません。

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

定義:

インタフェース ItemSelectable 内の addItemListener

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

removeItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), ItemEvent, ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

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

AWT スレッドモデルの詳細については、「AWT Threading Issues」を参照してください。

定義:

インタフェース ItemSelectable 内の removeItemListener

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

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

getItemListeners

public ItemListener[] getItemListeners()

この選択範囲に登録されているすべての項目リスナーの配列を返します。

戻り値:

この選択範囲のすべての ItemListener。または現在項目リスナーが登録されていない場合は空の配列

導入されたバージョン:

1.4

関連項目:

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

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

この Choice に FooListener として現在登録されているすべてのオブジェクトの配列を返します。FooListener は、addFooListener メソッドを使用して登録します。

FooListener.class といったクラスリテラルを使用して、listenerType 引数を指定できます。たとえば、この項目リスナーに対する Choice c の照会は次のコードで行います。

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

このようなリスナーがない場合は空の配列を返します。

オーバーライド:

クラス Component 内の getListeners

パラメータ:

listenerType - 要求されるリスナーの型。java.util.EventListener の下位インタフェースを指定

戻り値:

この選択範囲に FooListener として登録されているすべてのオブジェクトの配列。またはそのようなリスナーが追加されていない場合は空の配列

例外:

ClassCastException - listenerType が java.util.EventListener を実装するクラスまたはインタフェースを指定しない場合

導入されたバージョン:

1.3

関連項目:

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

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

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

オーバーライド:

クラス Component 内の processEvent

パラメータ:

e - イベント

導入されたバージョン:

JDK1.1

関連項目:

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

processItemEvent

protected void processItemEvent(ItemEvent e)

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

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

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

イベントパラメータが null の場合の動作は定義されていないため例外がスローされます。

パラメータ:

e - 項目イベント

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, addItemListener(ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

この Choice メニューの状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:

クラス Component 内の paramString

戻り値:

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

この Choice に関連付けられる AccessibleContext を取得します。AccessibleContext は Choice のフォームを AccessibleAWTChoice から取得します。必要な場合は新しい AccessibleAWTChoice インスタンスを生成します。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス Component 内の getAccessibleContext

戻り値:

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

導入されたバージョン:

1.3