- すべての実装されたインタフェース:
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
内に含まれる項目のフォント・サイズや長さなどの属性で決定される場合がよくあります。
- 導入されたバージョン:
- 1.0
- 関連項目:
- 直列化された形式
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 protected class
Choice.AccessibleAWTChoice
このクラスはChoice
クラス用のアクセシビリティ・サポートを実装しています。クラス java.awt.Componentで宣言されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
フィールドのサマリー
クラス java.awt.Componentで宣言されたフィールド
accessibleContext, 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(クラス<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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
-
コンストラクタの詳細
-
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
- 関連項目:
Component.getToolkit()
-
getItemCount
public int getItemCount()このChoice
メニュー内の項目の数を返します。- 戻り値:
- この
Choice
メニュー内の項目数 - 導入されたバージョン:
- 1.1
- 関連項目:
getItem(int)
-
countItems
@Deprecated public int countItems()非推奨。JDK Version 1.1以降は、getItemCount()
に置き換えられています。このChoice
メニュー内の項目の数を返します。- 戻り値:
- この
Choice
メニュー内の項目数
-
getItem
public String getItem(int index)このChoice
メニュー内の指定されたインデックスの位置にある文字列を取得します。- パラメータ:
index
- 開始位置を示すインデックス- 戻り値:
- 指定されたインデックスのアイテム
- 関連項目:
getItemCount()
-
add
public void add(String item)このChoice
メニューに項目を追加します。- パラメータ:
item
- 追加される項目- 例外:
NullPointerException
- 項目の値がnull
の場合- 導入されたバージョン:
- 1.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
- その項目が選択メニューに存在しない場合- 導入されたバージョン:
- 1.1
-
remove
public void remove(int position)選択メニューから、指定された位置にある項目を削除します。 現在選択されている項目が削除対象の場合、選択の最初の項目が選択項目になります。 削除対象になっていない場合、現在の項目がそのまま選択されます(選択されたインデックスが必要に応じて更新されます)。- パラメータ:
position
- 項目の位置- 例外:
IndexOutOfBoundsException
- 指定された位置が範囲外である場合- 導入されたバージョン:
- 1.1
-
removeAll
public void removeAll()選択メニューからすべての項目を削除します。- 導入されたバージョン:
- 1.1
- 関連項目:
remove(java.lang.String)
-
getSelectedItem
public String getSelectedItem()現在の選択の文字列表現を取得します。- 戻り値:
- この選択メニューで現在選択されている項目の文字列表現
- 関連項目:
getSelectedIndex()
-
getSelectedObjects
public Object[] getSelectedObjects()現在選択されている項目を含む配列(長さ1)を返します。 選択されている項目がない場合は、null
を返します。- 定義:
getSelectedObjects
、インタフェース:ItemSelectable
- 戻り値:
- 選択されたオブジェクトのリスト、または
null
- 関連項目:
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のスレッドの問題」を参照してください。
- 定義:
addItemListener
、インタフェース:ItemSelectable
- パラメータ:
l
- 項目リスナー- 導入されたバージョン:
- 1.1
- 関連項目:
removeItemListener(java.awt.event.ItemListener)
,getItemListeners()
,select(int)
,ItemEvent
,ItemListener
-
removeItemListener
public void removeItemListener(ItemListener l)指定された項目リスナーを削除して、このChoice
メニューから項目イベントが受信されなくなるようにします。 lがnull
である場合、例外はスローされず、何も処理は行われません。AWTスレッド・モデルの詳細は、「AWTのスレッドの問題」を参照してください。
- 定義:
removeItemListener
、インタフェース:ItemSelectable
- パラメータ:
l
- 項目リスナー- 導入されたバージョン:
- 1.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
- 型パラメータ:
T
- リスナーの型- パラメータ:
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
- イベント- 導入されたバージョン:
- 1.1
- 関連項目:
ItemEvent
,processItemEvent(java.awt.event.ItemEvent)
-
processItemEvent
protected void processItemEvent(ItemEvent e)このChoice
メニューで発生する項目イベントを、登録されているすべてのItemListener
オブジェクトにディスパッチすることによって処理します。項目イベントがこのコンポーネント用に使用可能になっていないかぎり、このメソッドは呼び出されません。 項目イベントは、次の項目の1つが発生したときに使用可能になります。
ItemListener
オブジェクトがaddItemListener
によって登録されている。enableEvents
によって項目イベントが使用可能になっている。
イベント・パラメータが
null
である場合は、動作が未指定のため、例外が発生する可能性があります。- パラメータ:
e
- 項目イベント- 導入されたバージョン:
- 1.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
-