JavaTM Platform
Standard Ed. 6

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)
          この ChoiceFooListener として現在登録されているすべてのオブジェクトの配列を返します。
 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)
この ChoiceFooListener として現在登録されているすべてのオブジェクトの配列を返します。FooListener は、addFooListener メソッドを使用して登録します。

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

ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
このようなリスナーがない場合は空の配列を返します。

オーバーライド:
クラス Component 内の getListeners
パラメータ:
listenerType - 要求されるリスナーの型。java.util.EventListener の下位インタフェースを指定
戻り値:
この選択範囲に FooListener として登録されているすべてのオブジェクトの配列。またはそのようなリスナーが追加されていない場合は空の配列
例外:
ClassCastException - listenerTypejava.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 を取得します。AccessibleContextChoice のフォームを AccessibleAWTChoice から取得します。必要な場合は新しい AccessibleAWTChoice インスタンスを生成します。

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス Component 内の getAccessibleContext
戻り値:
この ChoiceAccessibleContext として機能する AccessibleAWTChoice
導入されたバージョン:
1.3

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。