JavaTM 2
Platform
Std. Ed. v1.4.0

java.awt
クラス Choice

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Choice
すべての実装インタフェース:
Accessible, ImageObserver, ItemSelectable, MenuContainer, Serializable

public class Choice
extends Component
implements ItemSelectable, Accessible

Choice クラスは選択範囲のポップアップメニューを表します。現在の選択範囲は、メニューのタイトルとして表示されます。

次のコード例では、ポップアップメニューを生成します。



 Choice ColorChooser = new Choice();
 ColorChooser.add("Green");
 ColorChooser.add("Red");
 ColorChooser.add("Blue");
 

この選択範囲メニューがパネルに追加されると、通常の状態では次のように表示されます。

この図では 緑色の箇所 が現在の選択範囲です。オブジェクト上でマウスボタンを押すと、現在の選択範囲がハイライトされた状態でメニューが表示されます。

Choice コンポーネントの任意のサイズ変更をネイティブサポートしていないプラットフォームがあり、setSize() または getSize() の動作がこれによって制限を受ける場合があります。ネイティブな GUI Choice コンポーネントのサイズは、Choice 内に含まれる項目のフォントサイズや長さなどの属性で決定される場合がよくあります。

導入されたバージョン:
JDK1.0
関連項目:
直列化された形式

入れ子クラスの概要
protected  class Choice.AccessibleAWTChoice
          このクラスは Choice クラス用のユーザ補助機能のサポートを実装しています。
 
クラス java.awt.Component から継承した入れ子クラス
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 バージョン 1.1 以降は getItemCount() を使用
 AccessibleContext getAccessibleContext()
          この Choice に関連付けられる AccessibleContext を取得します。
 String getItem(int index)
          この Choice メニュー内の指定されたインデックスの文字列を返します。
 int getItemCount()
          この Choice メニュー内の項目数を返します。
 ItemListener[] getItemListeners()
          この選択範囲に登録されているすべての項目リスナーの配列を返します。
 EventListener[] getListeners(Class listenerType)
          この ChoiceFooListener として現在登録されているすべてのオブジェクトの配列を返します。
 int getSelectedIndex()
          現在選択されている項目のインデックスを返します。
 String getSelectedItem()
          現在選択されている文字列表現を返します。
 Object[] getSelectedObjects()
          現在選択されている項目を含む配列 (長さ 1) を返します。
 void insert(String item, int index)
          項目をこの選択範囲の指定された位置に挿入します。
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, getAlignmentX, getAlignmentY, getBackground, 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, 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, isOpaque, 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, setName, 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

public int countItems()
推奨されていません。 JDK バージョン 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 - インデックスがゼロより小さい場合

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()
現在選択されている項目のインデックスを返します。

関連項目:
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 の場合、例外はスローされず、処理も実行されません。

定義:
インタフェース ItemSelectable 内の addItemListener
パラメータ:
l - 項目リスナー
導入されたバージョン:
JDK1.1
関連項目:
removeItemListener(java.awt.event.ItemListener), getItemListeners(), select(int), ItemEvent, ItemListener

removeItemListener

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

定義:
インタフェース 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 EventListener[] getListeners(Class listenerType)
この ChoiceFooListener として現在登録されているすべてのオブジェクトの配列を返します。この FooListeneraddFooListener メソッドで登録されたものです。

listenerType 引数は FooListener.class のようなクラスリテラルで指定できます。たとえば、この項目リスナーに対する 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 オブジェクトにディスパッチすることにより、項目イベントを処理します。

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

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

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

パラメータ:
e - 項目イベント
導入されたバージョン:
JDK1.1
関連項目:
ItemEvent, ItemListener, addItemListener(java.awt.event.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

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.