java.awt
クラス Choice

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Choice

public class Choice

extends Component

implements ItemSelectable

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

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

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

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

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

導入されたバージョン:

JDK1.0

関連項目:

直列化された形式

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

コンストラクタの概要

Choice()
新しい選択メニューを作成します。

メソッドの概要

void	add(String item) この Choice メニューに項目を追加します。
void	addItem(String item) この Choice に項目を追加します。
void	addItemListener(ItemListener l) この Choice メニューから項目イベントを受け取れるように、指定された項目リスナーを追加します。
void	addNotify() Choice のピアを作成します。
int	countItems() 推奨されません。 JDK バージョン 1.1 以降は、getItemCount() に置き換えられました。
String	getItem(int index) この Choice メニュー内の指定された添字の文字列を取得します。
int	getItemCount() この Choice メニュー内の項目数を返します。
int	getSelectedIndex() 現在選択されている項目の添字を返します。
String	getSelectedItem() 現在の選択の文字列表現を取得します。
Object[]	getSelectedObjects() 現在選択されている項目を含む配列 (長さが1) を返します。
void	insert(String item, int index) この Choice の指定された位置に項目を挿入します。
protected String	paramString() この選択メニューの状態を表すパラメータ文字列を返します。
protected void	processEvent(AWTEvent e) この Choice のイベントを処理します。
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, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getName, getParent, getPeer, getPreferredSize, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, 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, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFont, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, update, validate

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

Choice

public Choice()

新しい選択メニューを作成します。初期状態では、メニューには項目がありません。

デフォルトでは、select メソッドを呼び出すことによってユーザが別の選択を行うまで、選択メニューに追加された最初の項目が選択項目になります。

関連項目:

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 メニュー内の項目数を返します。

導入されたバージョン:

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)

この Choice に項目を追加します。

パラメータ:

item - 追加される項目

例外:

NullPointerException - その項目の値が null に等しい場合

insert

public void insert(String item,
                   int index)

この Choice の指定された位置に項目を挿入します。

パラメータ:

item - 挿入する項目

index - 項目が挿入される位置

例外:

IllegalArgumentException - 添字が 0 より小さい場合

remove

public void remove(String item)

Choice メニューから最初の item を削除します。

パラメータ:

item - この Choice メニューから削除される項目

例外:

IllegalArgumentException - 選択メニューに項目がない場合

導入されたバージョン:

JDK1.1

remove

public void remove(int position)

選択メニューから、指定された位置にある項目を削除します。

パラメータ:

position - 項目の位置

導入されたバージョン:

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 メニューの選択項目を、指定された位置にある項目に設定します。

パラメータ:

pos - 選択項目の位置

例外:

IllegalArgumentException - 指定された位置が無効の場合

関連項目:

getSelectedItem(), getSelectedIndex()

select

public void select(String str)

この Choice メニューの選択項目を、指定された文字列と名前が同じである項目に設定します。指定された文字列に一致する項目が複数ある場合は、インデックス値がもっとも小さい項目が選択されます。

パラメータ:

str - 指定された文字列

関連項目:

getSelectedItem(), getSelectedIndex()

addItemListener

public void addItemListener(ItemListener l)

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

定義:

インタフェース ItemSelectable 内の addItemListener

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, removeItemListener(java.awt.event.ItemListener)

removeItemListener

public void removeItemListener(ItemListener l)

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

定義:

インタフェース ItemSelectable 内の removeItemListener

パラメータ:

l - 項目リスナー

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener)

processEvent

protected void processEvent(AWTEvent e)

この Choice のイベントを処理します。イベントが ItemEvent のインスタンスである場合は、processItemEvent メソッドを呼び出します。そうでない場合は、スーパークラスの processEvent メソッドを呼び出します。

パラメータ:

e - イベント

オーバーライド:

クラス Component 内の processEvent

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, processItemEvent(java.awt.event.ItemEvent)

processItemEvent

protected void processItemEvent(ItemEvent e)

この Choice メニューで発生する項目イベントを、登録されているすべての ItemListener オブジェクトにディスパッチすることにより、項目イベントを処理します。

このコンポーネントで項目イベントが使用可能でない場合、このメソッドは呼び出されません。項目イベントは、次のどれかの場合に使用可能になります。

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

パラメータ:

e - 項目イベント

導入されたバージョン:

JDK1.1

関連項目:

ItemEvent, ItemListener, addItemListener(java.awt.event.ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

この選択メニューの状態を表すパラメータ文字列を返します。この文字列はデバッグの際に便利です。

戻り値:

この Choice メニューのパラメータ文字列

オーバーライド:

クラス Component 内の paramString