java.awt

Class Choice

java.lang.Object

java.awt.Component

java.awt.Choice

All Implemented Interfaces:

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

另请参见：

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Choice.AccessibleAWTChoice 这个类实现了对 Choice类可访问性支持。

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法

Constructor and Description
Choice() 创建一个新的选择菜单。

方法摘要

Modifier and Type	Method and Description
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() 获取与此相关的 AccessibleContext Choice。
String	getItem(int index) 在这 Choice菜单指定索引的字符串。
int	getItemCount() 返回在这 Choice菜单项的数量。
ItemListener[]	getItemListeners() 返回在这个选择上注册的所有项目侦听器的数组。
<T extends EventListener> T[]	getListeners(类<T> listenerType) 返回对象的当前注册为 FooListeners在这 Choice数组。
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) 消除 item首次出现从 Choice菜单。
void	removeAll() 从选择菜单中移除所有项目。
void	removeItemListener(ItemListener l) 中移除指定的项的倾听者，不再接收项目事件从这 Choice菜单。
void	select(int pos) 设置选定的项目在这 Choice菜单作为一项在指定的位置。
void	select(String str) 设置选定的项目在这 Choice菜单是名字等于字符串的项。

Methods inherited from class 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, 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, revalidate, 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

Methods inherited from class java.lang.Object

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

Constructor Detail

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

另请参见：

Toolkit.createChoice(java.awt.Choice)， Component.getToolkit()

getItemCount

public int getItemCount()

返回在这 Choice菜单项的数量。

结果

在这 Choice菜单项的数量

从以下版本开始：

JDK1.1

另请参见：

getItem(int)

countItems

@Deprecated
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移了一个能容纳新的项目。如果 index大于或等于该选择项的数目， item添加到这个选择结束。

如果该项目是第一个被添加到选择，那么该项目将被选中。否则，如果选择的项目是一个项目转移，在选择的第一个项目成为选定项目。如果所选项目在那些被转移的，它仍然是选定的项目。

参数

item - non- null项目被插入

index的位置在该项应插入

异常

IllegalArgumentException如果指数小于0

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。

Specified by:

getSelectedObjects 接口 ItemSelectable

另请参见：

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。如果我是 null，不引发异常，则不执行行动。

指对AWT的线程模型的细节AWT Threading Issues。

Specified by:

addItemListener 接口 ItemSelectable

参数

l -项目的倾听者

从以下版本开始：

JDK1.1

另请参见：

removeItemListener(java.awt.event.ItemListener)， getItemListeners()， select(int)， ItemEvent， ItemListener

removeItemListener

public void removeItemListener(ItemListener l)

中移除指定的项的倾听者，不再接收项目事件从这 Choice菜单。如果我是 null，不引发异常，则不执行行动。

参考AWT Threading Issues对AWT的线程模型的细节。

Specified by:

removeItemListener 接口 ItemSelectable

参数

l -项目的倾听者

从以下版本开始：

JDK1.1

另请参见：

addItemListener(java.awt.event.ItemListener)， getItemListeners()， ItemEvent， ItemListener

getItemListeners

public ItemListener[] getItemListeners()

返回在这个选择上注册的所有项目侦听器的数组。

结果

所有这些选择的 ItemListeners或空数组如果没有项目的听众正在注册

从以下版本开始：

一点四

另请参见：

addItemListener(java.awt.event.ItemListener)， removeItemListener(java.awt.event.ItemListener)， ItemEvent， ItemListener

getListeners

public <T extends EventListener> T[] getListeners(类<T> listenerType)

返回对象的当前注册为 FooListeners在这 Choice数组。 FooListeners使用 addFooListener方法注册。如果没有这样

您可以指定一个类的listenerType字面的说法，如FooListener.class。例如，你可以查询其产品的听众与下面的代码一Choice c：

itemlistener [] ILS =（itemlistener [ ]）（c.getlisteners（itemlistener。类））；

听众的存在，此方法将返回空数组。

重写：

getListeners 方法重写，继承类 Component

参数

listenerType -听众的类型要求；这个参数应该指定一个接口，从 java.util.EventListener

结果

所有对象注册为这个选择 FooListeners数组，或一个空数组如果没有这样的听众已添加

异常

ClassCastException -如果 listenerType不指定一个类或接口实现 java.util.EventListener

从以下版本开始：

一点三

另请参见：

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

在这个选择上处理事件。如果事件是 ItemEvent实例，它调用 processItemEvent方法。否则，它调用父类的方法 processEvent。

注意，如果参数是null行为是不可能导致异常。

重写：

processEvent 方法重写，继承类 Component

参数

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。

重写：

paramString 方法重写，继承类 Component

结果

这 Choice菜单参数字符串

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的 AccessibleContext Choice。对于 Choice组件的 AccessibleContext以一个 AccessibleAWTChoice形式。一个新的 AccessibleAWTChoice实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Component

结果

一个 AccessibleAWTChoice作为本 Choice的 AccessibleContext

从以下版本开始：

一点三