类 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" 为当前选择。在对象上按下鼠标按钮，将显示一个菜单，菜单的当前选择被加亮。

构造子索引

Choice()

创建一个新的选择菜单。

方法索引

add(String)

添加一项到这个 Choice 菜单中。

addItem(String)

添加一项到这个 Choice 中。

addItemListener(ItemListener)

添加指定的项监听者，接收这个 Choice 菜单的项事件。

addNotify()

创建 Choice 的同级件。

countItems()

不推荐使用该方法。

getItem(int)

获取这个 Choice 菜单中指定下标处的字符串。

getItemCount()

返回这个 Choice 菜单中的项数。

getSelectedIndex()

返回当前选中项的下标。

getSelectedItem()

获取当前选择的字符串表示。

getSelectedObjects()

返回包含当前选中的项的数组 ( 长度为 1 ) 。

insert(String, int)

将项插入到这个选择的指定的位置。

paramString()

返回表示当前菜单状态的参数字符串。

processEvent(AWTEvent)

处理这个选项上的事件。

processItemEvent(ItemEvent)

通过将项事件分配给任意已注册的 ItemListener 对象，来处理发生在该 Choice 上的项事件。

remove(int)

删除选择菜单的指定位置处的项。

remove(String)

从 Choice 菜单中删除第一个产生项。

removeAll()

删除选择菜单中的所有项。

removeItemListener(ItemListener)

删除指定的项监听者，使其不再接收这个 Choice 菜单的项事件。

select(int)

设置 Choice 菜单中的选中项为指定位置处的项。

select(String)

设置 Choice 菜单中的选中项为名字与指定字符串相等的项。

构造子

 public Choice()

创建一个新的选择菜单。初始菜单中不包含项。

缺省情况下，第一个加入到选择菜单中的项成为选中项，直到用户调用一个 select 方法产生一个不同的选择。

参见：

select, select

方法

 public void addNotify()

创建 Choice 的同级件。该同级件允许在不改变 Choice 功能的情况下改变其外观。

覆盖：

类 Component 中的 addNotify

参见：

createChoice, getToolkit

 public int getItemCount()

返回这个 Choice 菜单中的项数。

参见：

getItem

 public int countItems()

注意：不推荐使用 countItems() 方法。 同 JDK 1.1 版一样，用 getItemCount() 方法替换该方法。

 public String getItem(int index)

获取这个 Choice 菜单中指定下标处的字符串。

参数：

index - 起始下标。

参见：

getItemCount

 public synchronized void add(String item)

添加一项到 Choice 菜单中。

参数：

item - 添加的项

抛出： NullPointerException

若项的值是 null 。

 public synchronized void addItem(String item)

添加一项到这个 Choice 中。

参数：

item - 添加的项

抛出： NullPointerException

若项的值为 null 。

 public synchronized void insert(String item,
                                 int index)

将该项插入到该选择的指定位置。

参数：

item - 插入的项

index - 项的插入位置

抛出： IllegalArgumentException

若下标小于 0 。

 public synchronized void remove(String item)

从 Choice 菜单中删除第一个产生项 。

参数：

item - 从这个 Choice 菜单删除的项。

抛出： IllegalArgumentException

若要删除的项不在选择菜单中。

 public synchronized void remove(int position)

删除选择菜单的指定位置处的项。

参数：

position - 项的位置。

 public synchronized void removeAll()

删除选择菜单中的所有项。

参见：

remove

 public synchronized String getSelectedItem()

获取当前选择的字符串表示。

返回值：

这个选择菜单中当前选中项的字符串表示。

参见：

getSelectedIndex

 public synchronized Object[] getSelectedObjects()

返回包含当前选中的项的数组 ( 长度为 1 ) 。若这个选择不包含任何项，则返回 null 。

参见：

ItemSelectable

 public int getSelectedIndex()

返回当前选中项的下标。

参见：

getSelectedItem

 public synchronized void select(int pos)

设置 Choice 菜单中的选中项为指定位置处的项。

参数：

pos - 选中项的位置。

抛出： IllegalArgumentException

若指定位置无效。

参见：

getSelectedItem, getSelectedIndex

 public synchronized void select(String str)

设置 Choice 菜单中名字与指定字符串相等的项为选中项。若有多个项与指定的字符串匹配 ( 相等 ) ，选中下标最小的项。

参数：

str - 指定的字符串

参见：

getSelectedItem, getSelectedIndex

 public synchronized void addItemListener(ItemListener l)

添加指定的项监听者，接收这个 Choice 菜单的项事件。

参数：

l - 项监听者。

参见：

ItemEvent, ItemListener, removeItemListener

 public synchronized void removeItemListener(ItemListener l)

删除指定的项监听者，使其不再接收这个 Choice 的项事件。

参数：

l - 项监听者。

参见：

ItemEvent, ItemListener, addItemListener

 protected void processEvent(AWTEvent e)

处理这个选择上的事件。若事件是 ItemEvent 的一个实例，该方法调用 processItemEvent 方法。 否则，调用其父类的 processEvent 方法。

参数：

e - 事件。

覆盖：

类 Component 中的 processEvent

参见：

ItemEvent, processItemEvent

 protected void processItemEvent(ItemEvent e)

通过将项事件分配给任意已注册的 ItemListener 对象，来处理发生在该 Choice 上的项事件。

除非这个组件可以启用项事件，否则不能调用此方法。当下列条件之一发生时，可以启用项事件：

• 通过 addItemListener 方法，注册一个 ItemListener 对象。
• 通过 enableEvents 方法，使项事件可以启用。

参数：

e - 项事件。

参见：

ItemEvent, ItemListener, addItemListener, enableEvents

 protected String paramString()

返回表示该选择菜单状态的参数字符串。该字符串对调试有用。

返回值：

这个 Choice 菜单的参数字符串。

覆盖：

类 Component 中的 paramString