Choice (Java Platform SE 7)

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()
新しい選択メニューを作成します。

コンストラクタ
コンストラクタと説明
`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)` この選択の指定された位置に項目を挿入します。
`protected String`	`paramString()` この `Choice` メニューの状態を表す文字列を返します。
`protected void`	`processEvent(AWTEvent e)` この選択のイベントを処理します。
`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, 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, revalidate, 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 の機能を変更せずにその外観を変更できます。
    
    オーバーライド:
    
    addNotify、クラス: Component
    
    関連項目:
    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)
```
    この選択の指定された位置に項目を挿入します。index 以降の項目は 1 つずつ後に移動されます。index の値がこの選択の項目数以上の場合、item はこの選択の最後に追加されます。
    項目が選択に追加される最初の項目である場合、この項目が選択されます。最初の項目でない場合、選択される項目が移動される項目の場合は、選択の最初の項目が選択されます。移動される項目でない場合は、その項目がそのまま選択されます。
    
    パラメータ:
    item - 挿入される項目。null は指定不可
    index - 項目が挿入される位置
    
    例外:
    
    IllegalArgumentException - index が 0 より小さい場合
  - remove
```
public void remove(String item)
```
    Choice メニューから最初に表示される item を削除します。現在選択されている項目が削除対象の場合、選択の最初の項目が選択項目になります。削除対象になっていない場合、現在の項目がそのまま選択されます (選択されたインデックスが必要に応じて更新されます)。
    
    パラメータ:
    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 を返します。
    
    定義:
    
    getSelectedObjects、インタフェース: ItemSelectable
    
    関連項目:
    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」を参照してください。
    
    定義:
    
    addItemListener、インタフェース: ItemSelectable
    
    パラメータ:
    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」を参照してください。
    
    定義:
    
    removeItemListener、インタフェース: ItemSelectable
    
    パラメータ:
    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));
```
    このようなリスナーがない場合は空の配列を返します。
    オーバーライド:
    
    getListeners、クラス: Component
    
    パラメータ:
    listenerType - 要求されるリスナーの型。java.util.EventListener の子孫のインタフェースを指定してください
    
    戻り値:
    この選択上で FooListener として登録されたすべてのオブジェクトの配列、またはこのようなリスナーが登録されていない場合は空の配列
    
    例外:
    
    ClassCastException - listenerType で、java.util.EventListener を実装するクラスまたはインタフェースが指定されなかった場合
    導入されたバージョン:
    
    1.3
    
    関連項目:
    getItemListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    この選択のイベントを処理します。イベントが ItemEvent のインスタンスである場合は、processItemEvent メソッドを呼び出します。それ以外の場合は、そのスーパークラスの processEvent メソッドを呼び出します。
    イベントパラメータが null である場合は、動作が未指定のため、例外が発生する可能性があります。
    
    オーバーライド:
    
    processEvent、クラス: Component
    
    パラメータ:
    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 にはなりません。
    
    オーバーライド:
    
    paramString、クラス: Component
    
    戻り値:
    この Choice メニューのパラメータ文字列
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    この Choice に関連付けられた AccessibleContext を取得します。Choice コンポーネントの場合、AccessibleContext は AccessibleAWTChoice の形式を取ります。必要に応じて、新しい AccessibleAWTChoice インスタンスが作成されます。
    
    定義:
    
    getAccessibleContext、インタフェース: Accessible
    
    オーバーライド:
    
    getAccessibleContext、クラス: Component
    
    戻り値:
    この Choice の AccessibleContext として機能する AccessibleAWTChoice
    導入されたバージョン:
    
    1.3

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス Choice

ネストされたクラスのサマリー

クラス java.awt.Component から継承されたネストされたクラス/インタフェース

フィールドのサマリー

クラス java.awt.Component から継承されたフィールド

インタフェース java.awt.image.ImageObserver から継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

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

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

コンストラクタの詳細

Choice

メソッドの詳細

addNotify

getItemCount

countItems

getItem

add

addItem

insert

remove

remove

removeAll

getSelectedItem

getSelectedObjects

getSelectedIndex

select

select

addItemListener

removeItemListener

getItemListeners

getListeners

processEvent

processItemEvent

paramString

getAccessibleContext