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
内に含まれる項目のフォント・サイズや長さなどの属性で決定される場合がよくあります。
修飾子と型 | クラス | 説明 |
---|---|---|
protected class |
Choice.AccessibleAWTChoice |
このクラスは
Choice クラス用のアクセシビリティ・サポートを実装しています。 |
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
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> |
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 メニュー内の選択された項目を、名前が指定された文字列に等しい項目になるように設定します。 |
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
public Choice() throws HeadlessException
デフォルトでは、select
メソッドの呼出しでユーザーが別の選択を行うまで、選択メニューに追加された最初の項目が選択項目になります。
HeadlessException
- GraphicsEnvironment.isHeadless()がtrueを返す場合GraphicsEnvironment.isHeadless()
, select(int)
, select(java.lang.String)
public void addNotify()
Choice
のピアを作成します。 このピアにより、Choice
の機能を変更せずにその外観を変更できます。 addNotify
、クラスComponent
Toolkit.createChoice(java.awt.Choice)
, Component.getToolkit()
public int getItemCount()
Choice
メニュー内の項目の数を返します。Choice
メニュー内の項目数getItem(int)
@Deprecated 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)
add
メソッドを使用してください。
このChoice
メニューに項目を追加します。
item
- 追加される項目NullPointerException
- 項目の値がnull
に等しい場合public void insert(String item, int index)
index
以降の項目は1つずつ後に移動されます。 index
の値がこの選択の項目数以上の場合、item
はこの選択の最後に追加されます。
項目が選択に追加される最初の項目である場合、この項目が選択されます。 最初の項目でない場合、選択される項目が移動される項目の場合は、選択の最初の項目が選択されます。 移動される項目でない場合は、その項目がそのまま選択されます。
item
- 挿入される項目。null
は指定不可index
- 項目が挿入される位置IllegalArgumentException
- indexが0より小さい場合public void remove(String item)
Choice
メニューから最初に表示されるitem
を削除します。 現在選択されている項目が削除対象の場合、選択の最初の項目が選択項目になります。 削除対象になっていない場合、現在の項目がそのまま選択されます(選択されたインデックスが必要に応じて更新されます)。 item
- このChoice
メニューから削除される項目IllegalArgumentException
- その項目が選択メニューに存在しない場合public void remove(int position)
position
- 項目の位置IndexOutOfBoundsException
- 指定された位置が範囲外である場合public void removeAll()
remove(java.lang.String)
public String getSelectedItem()
getSelectedIndex()
public Object[] getSelectedObjects()
null
を返します。 getSelectedObjects
、インタフェースItemSelectable
ItemSelectable
public int getSelectedIndex()
getSelectedItem()
public void select(int pos)
Choice
メニュー内の選択された項目を、指定された位置にある項目になるように設定します。
このメソッドは、主にこのコンポーネント内の項目を初期状態で選択するために使用されます。 このメソッドをプログラムによって呼び出した場合、ItemEvent
はトリガーされません。 ItemEvent
をトリガーするための唯一の方法は、ユーザーの操作です。
pos
- 選択項目の位置IllegalArgumentException
- 指定された位置が項目の数より大きいか、ゼロより小さい場合getSelectedItem()
, getSelectedIndex()
public void select(String str)
Choice
メニュー内の選択された項目を、名前が指定された文字列に等しい項目になるように設定します。 指定された文字列と同じ名前の項目が複数ある場合は、インデックス値がもっとも小さい項目が選択されます。
このメソッドは、主にこのコンポーネント内の項目を初期状態で選択するために使用されます。 このメソッドをプログラムによって呼び出した場合、ItemEvent
はトリガーされません。 ItemEvent
をトリガーするための唯一の方法は、ユーザーの操作です。
str
- 指定された文字列getSelectedItem()
, getSelectedIndex()
public void addItemListener(ItemListener l)
Choice
メニューから項目イベントを受信するために、指定された項目リスナーを追加します。 項目イベントはselect
の呼出しではなく、ユーザーの入力に反応してリスナーに送信されます。 lがnull
である場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
addItemListener
、インタフェースItemSelectable
l
- 項目リスナーremoveItemListener(java.awt.event.ItemListener)
, getItemListeners()
, select(int)
, ItemEvent
, ItemListener
public void removeItemListener(ItemListener l)
Choice
メニューから項目イベントが受信されなくなるようにします。 lがnull
である場合、例外はスローされず、何も処理は行われません。
AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
removeItemListener
、インタフェースItemSelectable
l
- 項目リスナーaddItemListener(java.awt.event.ItemListener)
, getItemListeners()
, ItemEvent
, ItemListener
public ItemListener[] getItemListeners()
ItemListener
。項目リスナーが現在登録されていない場合は空の配列addItemListener(java.awt.event.ItemListener)
, removeItemListener(java.awt.event.ItemListener)
, ItemEvent
, ItemListener
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
を実装するクラスまたはインタフェースが指定されなかった場合getItemListeners()
protected void processEvent(AWTEvent e)
ItemEvent
のインスタンスである場合は、processItemEvent
メソッドを呼び出します。 それ以外の場合は、そのスーパー・クラスのprocessEvent
メソッドを呼び出します。
イベント・パラメータがnull
である場合は、動作が未指定のため、例外が発生する可能性があります。
processEvent
、クラスComponent
e
- イベントItemEvent
, processItemEvent(java.awt.event.ItemEvent)
protected void processItemEvent(ItemEvent e)
Choice
メニューで発生する項目イベントを、登録されているすべてのItemListener
オブジェクトにディスパッチすることによって処理します。
項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。 項目イベントは、次の項目の1つが発生したときに使用可能になります。
ItemListener
オブジェクトがaddItemListener
によって登録されている。
enableEvents
によって項目イベントが使用可能になっている。
イベント・パラメータがnull
である場合は、動作が未指定のため、例外が発生する可能性があります。
e
- 項目イベントItemEvent
, ItemListener
, addItemListener(ItemListener)
, Component.enableEvents(long)
protected String paramString()
Choice
メニューの状態を表す文字列を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる場合があります。 返される文字列は空の場合がありますが、null
にはなりません。 paramString
、クラスComponent
Choice
メニューのパラメータ文字列public AccessibleContext getAccessibleContext()
Choice
に関連付けられたAccessibleContext
を取得します。 Choice
コンポーネントの場合、AccessibleContext
はAccessibleAWTChoice
の形式を取ります。 必要に応じて、新しいAccessibleAWTChoice
インスタンスが作成されます。 getAccessibleContext
、インタフェースAccessible
getAccessibleContext
、クラスComponent
Choice
のAccessibleContext
として機能するAccessibleAWTChoice
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。