java.awt
类 Choice

java.lang.Object
  java.awt.Component
      java.awt.Choice

所有已实现的接口：

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 中包含的项的长度。

从以下版本开始：

JDK1.0

另请参见：

序列化表格

嵌套类摘要

protected class

Choice.AccessibleAWTChoice 此类实现对 Choice 类的可访问性支持。

从类 java.awt.Component 继承的嵌套类/接口

Component.AccessibleAWTComponent, 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 platform v1.1 已过时，请使用 add 方法替换。
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(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 菜单中的选定项设置为其名称等于指定字符串的项。

从类 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, 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, 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

从类 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

@Deprecated
public int countItems()

已过时。 从 JDK version 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 platform v1.1 已过时，请使用 add 方法替换。

将一个项添加到此 Choice 菜单中。

参数：

item - 要添加的菜单项

抛出：

NullPointerException - 如果这个项的值等于 null

insert

public void insert(String item,
                   int index)

将菜单项插入此选择的指定位置上。如果某个索引上存在的项大于或等于 index，则将它上移一位，以容纳新的项。如果 index 大于或等于此选择中项的数目，则将 item 添加到此选择的结尾处。

如果此项是第一个添加到该选择中的项，则这个项将成为选定项。否则，如果选定项是上移项中的一个，则该选择中的第一个项将成为选定项。如果选定项不在这些上移项中，则它仍然是选定项。

参数：

item - 将插入的非 null 项

index - 应该插入项的位置

抛出：

IllegalArgumentException - 如果索引小于 0

remove

public void remove(String item)

移除 Choice 菜单中第一个出现的 item。如果正被移除的项是目前选定的项，则该选择中的第一个项将成为选定项。否则，当前选定项仍然是选定项（并且选定的索引被相应地更新）。

参数：

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()

返回当前选定项的索引。如果没有选定任何内容，则返回 -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，则不会抛出异常，并且不执行任何操作。

指定者：

接口 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 <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回目前已在此 Choice 上注册为 FooListener 的所有对象的数组。FooListener 是使用 addFooListener 方法注册的。

可以用一个类字面值（比如 FooListener.class）指定 listenerType 参数。例如，可以使用以下代码查询 Choice c，以获得它的项侦听器：

ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));

如果不存在这样的侦听器，则此方法将返回一个空数组。

覆盖：

类 Component 中的 getListeners

参数：

listenerType - 所请求侦听器的类型；该参数应该指定一个从 java.util.EventListener 遗传下来的界面

返回：

在此选择上注册为 FooListener 的所有对象的数组，如果没有添加这样的侦听器，则返回一个空数组

抛出：

ClassCastException - 如果 listenerType 没有指定实现 java.util.EventListener 的类或接口

从以下版本开始：

1.3

另请参见：

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

处理关于此选择的事件。如果事件是 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(ItemListener), Component.enableEvents(long)

paramString

protected String paramString()

返回表示此 Choice 菜单的状态的字符串。此方法仅在进行调试的时候使用，对于这两个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 Component 中的 paramString

返回：

此 Choice 菜单的参数字符串

getAccessibleContext

public AccessibleContext getAccessibleContext()

获得与此 Choice 相关的 AccessibleContext。对于 Choice 组件，AccessibleContext 采用的是 AccessibleAWTChoice 的形式。如有必要，可以创建一个新的 AccessibleAWTChoice 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 Component 中的 getAccessibleContext

返回：

充当此 Choice 的 AccessibleContext 的 AccessibleAWTChoice