JComboBox (Java Platform SE 8 )

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JComboBox<E>

参数类型

E - 这个组合框的元素的类型

All Implemented Interfaces:

ActionListener ， ImageObserver ， ItemSelectable ， MenuContainer ， Serializable ， EventListener ， Accessible ， ListDataListener
```
public class JComboBox<E>
extends JComponent
implements ItemSelectable, ListDataListener, ActionListener, Accessible
```
组合按钮或可编辑字段和下拉列表的组件。用户可以根据用户的请求从下拉列表中选择一个值。如果使组合框可编辑，则组合框包含用户可以键入值的可编辑字段。
警告： Swing不是线程安全的。有关更多信息，请参阅Swing's Threading Policy 。

警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4开始，对所有JavaBeans的长期存储的支持已经添加到java.beans包中。请参阅XMLEncoder 。

见How to Use Combo Boxes在The Java Tutorial进一步的信息。

另请参见：

ComboBoxModel ， DefaultComboBoxModel

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`JComboBox.AccessibleJComboBox` 这个类实现了可访问性支持 `JComboBox`类。
`static interface`	`JComboBox.KeySelectionManager` 界面定义了一个 `KeySelectionManager` 。

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`actionCommand` 此保护字段是实现特定的。
`protected ComboBoxModel<E>`	`dataModel` 此保护字段是实现特定的。
`protected ComboBoxEditor`	`editor` 此保护字段是实现特定的。
`protected boolean`	`isEditable` 此保护字段是实现特定的。
`protected JComboBox.KeySelectionManager`	`keySelectionManager` 此保护字段是实现特定的。
`protected boolean`	`lightWeightPopupEnabled` 此保护字段是实现特定的。
`protected int`	`maximumRowCount` 此保护字段是实现特定的。
`protected ListCellRenderer<? super E>`	`renderer` 此保护字段是实现特定的。
`protected Object`	`selectedItemReminder` 此保护字段是实现特定的。

Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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
`JComboBox()` 使用默认数据模型创建 `JComboBox` 。
`JComboBox(ComboBoxModel<E> aModel)` 创建一个 `JComboBox` ，从现有的 `ComboBoxModel`获取其项目。
`JComboBox(E[] items)` 创建 `JComboBox`包含指定数组中的元素。
`JComboBox(Vector<E> items)` 创建一个 `JComboBox`包含指定Vector中的元素。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`actionPerformed(ActionEvent e)` 这种方法是公共的，作为实现的副作用。
`protected void`	`actionPropertyChanged(Action action, String propertyName)` 响应关联操作中的属性更改更新组合框的状态。
`void`	`addActionListener(ActionListener l)` 添加一个 `ActionListener` 。
`void`	`addItem(E item)` 将项目添加到项目列表。
`void`	`addItemListener(ItemListener aListener)` 添加一个 `ItemListener` 。
`void`	`addPopupMenuListener(PopupMenuListener l)` 添加一个 `PopupMenu`监听器，它将从组合框的弹出窗口中收听通知消息。
`void`	`configureEditor(ComboBoxEditor anEditor, Object anItem)` 用指定的项目初始化编辑器。
`protected void`	`configurePropertiesFromAction(Action a)` 设置此组合框上的属性，以匹配指定的Action中的 `Action` 。
`void`	`contentsChanged(ListDataEvent e)` 这种方法是公共的，作为实现的副作用。
`protected PropertyChangeListener`	`createActionPropertyChangeListener(Action a)` 创建并返回一个 `PropertyChangeListener` ，负责监听来自指定的变化 `Action`和更新相应的属性。
`protected JComboBox.KeySelectionManager`	`createDefaultKeySelectionManager()` 返回默认密钥选择管理器的一个实例。
`protected void`	`fireActionEvent()` 通知所有在此事件类型上通知有兴趣的听众。
`protected void`	`fireItemStateChanged(ItemEvent e)` 通知所有在此事件类型上通知有兴趣的听众。
`void`	`firePopupMenuCanceled()` 通知 `PopupMenuListener` s组合框的弹出部分已被取消。
`void`	`firePopupMenuWillBecomeInvisible()` 通知 `PopupMenuListener` s组合框的弹出部分已经变得不可见。
`void`	`firePopupMenuWillBecomeVisible()` 通知 `PopupMenuListener` s组合框的弹出部分将变得可见。
`AccessibleContext`	`getAccessibleContext()` 获取与此JComboBox关联的AccessibleContext。
`Action`	`getAction()` 返回当前设置 `Action`这个 `ActionEvent`来源，或 `null`如果没有 `Action`设置。
`String`	`getActionCommand()` 返回发送到动作侦听器的事件中包含的动作命令。
`ActionListener[]`	`getActionListeners()` 返回使用addActionListener（）添加到此JComboBox的所有 `ActionListener`的数组。
`ComboBoxEditor`	`getEditor()` 返回在 `JComboBox`字段中用于绘制和编辑所选项目的编辑器。
`E`	`getItemAt(int index)` 返回指定索引处的列表项。
`int`	`getItemCount()` 返回列表中的项目数。
`ItemListener[]`	`getItemListeners()` 返回使用addItemListener（）添加到此JComboBox的所有 `ItemListener`的数组。
`JComboBox.KeySelectionManager`	`getKeySelectionManager()` 返回列表的密钥选择管理器。
`int`	`getMaximumRowCount()` 返回在没有滚动条的情况下组合框可以显示的最大项数
`ComboBoxModel<E>`	`getModel()` 返回当前使用的数据模型 `JComboBox` 。
`PopupMenuListener[]`	`getPopupMenuListeners()` 返回使用addPopupMenuListener（）添加到此JComboBox的所有 `PopupMenuListener`的数组。
`E`	`getPrototypeDisplayValue()` 返回“原型显示”值 - 用于计算显示高度和宽度的对象。
`ListCellRenderer<? super E>`	`getRenderer()` 返回用于在 `JComboBox`字段中显示所选项目的渲染器。
`int`	`getSelectedIndex()` 返回列表中与给定项目匹配的第一个项目。
`Object`	`getSelectedItem()` 返回当前所选项目。
`Object[]`	`getSelectedObjects()` 返回一个包含所选项目的数组。
`ComboBoxUI`	`getUI()` 返回渲染此组件的L＆F对象。
`String`	`getUIClassID()` 返回呈现此组件的L＆F类的名称。
`void`	`hidePopup()` 导致组合框关闭其弹出窗口。
`void`	`insertItemAt(E item, int index)` 在给定索引的项目列表中插入项目。
`protected void`	`installAncestorListener()`
`void`	`intervalAdded(ListDataEvent e)` 这种方法是公共的，作为实现的副作用。
`void`	`intervalRemoved(ListDataEvent e)` 这种方法是公共的，作为实现的副作用。
`boolean`	`isEditable()` 如果 `JComboBox`是可编辑的，则返回true。
`boolean`	`isLightWeightPopupEnabled()` 获取 `lightWeightPopupEnabled`属性的值。
`boolean`	`isPopupVisible()` 确定弹出窗口的可见性。
`protected String`	`paramString()` 返回此 `JComboBox`的字符串表示 `JComboBox` 。
`void`	`processKeyEvent(KeyEvent e)` 手柄 `KeyEvent` s，寻找Tab键。
`void`	`removeActionListener(ActionListener l)` 删除 `ActionListener` 。
`void`	`removeAllItems()` 从项目列表中删除所有项目。
`void`	`removeItem(Object anObject)` 从项目列表中删除一个项目。
`void`	`removeItemAt(int anIndex)` `anIndex`删除该项目此方法仅在 `JComboBox`使用可变数据模型时有效。
`void`	`removeItemListener(ItemListener aListener)` 删除 `ItemListener` 。
`void`	`removePopupMenuListener(PopupMenuListener l)` 删除 `PopupMenuListener` 。
`protected void`	`selectedItemChanged()` 这种受保护的方法是具体的实现。
`boolean`	`selectWithKeyChar(char keyChar)` 选择与指定键盘字符相对应的列表项，如果存在与该字符相对应的项，则返回true。
`void`	`setAction(Action a)` 为 `Action`设置 `ActionEvent`源。
`void`	`setActionCommand(String aCommand)` 设置应该包含在发送到action监听器的事件中的action命令。
`void`	`setEditable(boolean aFlag)` 确定 `JComboBox`字段是否可编辑。
`void`	`setEditor(ComboBoxEditor anEditor)` 设置用于在 `JComboBox`字段中绘制和编辑所选项目的编辑器。
`void`	`setEnabled(boolean b)` 启用组合框，以便可以选择项目。
`void`	`setKeySelectionManager(JComboBox.KeySelectionManager aManager)` 设置将键盘字符转换为列表选择的对象。
`void`	`setLightWeightPopupEnabled(boolean aFlag)` 设置 `lightWeightPopupEnabled`属性，它提供了一个提示，一个轻量级的 `Component`是否应该用于包含 `JComboBox` ，而重量级 `Component` ，如 `Panel`或 `Window` 。
`void`	`setMaximumRowCount(int count)` 设置 `JComboBox`显示的最大行数。
`void`	`setModel(ComboBoxModel<E> aModel)` 设置 `JComboBox`用于获取项目列表的数据模型。
`void`	`setPopupVisible(boolean v)` 设置弹出窗口的可见性。
`void`	`setPrototypeDisplayValue(E prototypeDisplayValue)` 设置用于计算UI部分显示大小的原型显示值。
`void`	`setRenderer(ListCellRenderer<? super E> aRenderer)` 设置绘制列表项目的渲染器和从JComboBox字段中的列表中选择的项目。
`void`	`setSelectedIndex(int anIndex)` 选择索引为 `anIndex`的项目。
`void`	`setSelectedItem(Object anObject)` 将组合框显示区域中的选定项目设置为参数中的对象。
`void`	`setUI(ComboBoxUI ui)` 设置渲染此组件的L＆F对象。
`void`	`showPopup()` 导致组合框显示其弹出窗口。
`void`	`updateUI()` 将UI属性重置为当前外观的值。

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - dataModel
```
protected ComboBoxModel<E> dataModel
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    getModel() ， setModel(javax.swing.ComboBoxModel<E>)
  - renderer
```
protected ListCellRenderer<? super E> renderer
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    getRenderer() ， setRenderer(javax.swing.ListCellRenderer<? super E>)
  - editor
```
protected ComboBoxEditor editor
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    getEditor() ， setEditor(javax.swing.ComboBoxEditor)
  - maximumRowCount
```
protected int maximumRowCount
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    getMaximumRowCount() ， setMaximumRowCount(int)
  - isEditable
```
protected boolean isEditable
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    isEditable ， setEditable(boolean)
  - keySelectionManager
```
protected JComboBox.KeySelectionManager keySelectionManager
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager) ， getKeySelectionManager()
  - actionCommand
```
protected String actionCommand
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    setActionCommand(java.lang.String) ， getActionCommand()
  - lightWeightPopupEnabled
```
protected boolean lightWeightPopupEnabled
```
    此保护字段是实现特定的。不要直接访问或覆盖。改用accessor方法。
    
    另请参见：
    
    setLightWeightPopupEnabled(boolean) ， isLightWeightPopupEnabled()
  - selectedItemReminder
```
protected Object selectedItemReminder
```
    此保护字段是实现特定的。不要直接访问或覆盖。
- 构造方法详细信息
  - JComboBox
```
public JComboBox(ComboBoxModel<E> aModel)
```
    创建一个JComboBox ，从现有的ComboBoxModel获取其项目。由于提供了ComboBoxModel ，因此使用此构造函数创建的组合框不会创建默认组合框模型，并可能影响插入，删除和添加方法的行为。
    
    参数
    
    aModel -在 ComboBoxModel ，提供显示的项列表
    
    另请参见：
    
    DefaultComboBoxModel
  - JComboBox
```
public JComboBox(E[] items)
```
    创建一个JComboBox ，其中包含指定数组中的元素。默认情况下，数组中的第一个项目（因此数据模型）将被选中。
    
    参数
    
    items - 要插入组合框的对象数组
    
    另请参见：
    
    DefaultComboBoxModel
  - JComboBox
```
public JComboBox(Vector<E> items)
```
    创建一个JComboBox包含指定Vector中的元素。默认情况下，向量中的第一个项目（因此数据模型）将被选中。
    
    参数
    
    items - 要插入到组合框中的向量数组
    
    另请参见：
    
    DefaultComboBoxModel
  - JComboBox
```
public JComboBox()
```
    创建一个带有默认数据模型的JComboBox 。默认数据模型是一个空的对象列表。使用addItem添加项目。默认情况下，数据模型中的第一个项目被选中。
    
    另请参见：
    
    DefaultComboBoxModel
- 方法详细信息
  - installAncestorListener
```
protected void installAncestorListener()
```
  - setUI
```
public void setUI(ComboBoxUI ui)
```
    设置渲染此组件的L＆F对象。
    
    参数
    
    ui - ComboBoxUI L＆F对象
    
    另请参见：
    
    UIDefaults.getUI(javax.swing.JComponent)
  - updateUI
```
public void updateUI()
```
    将UI属性重置为当前外观的值。
    
    重写：
    
    updateUI在 JComponent
    
    另请参见：
    
    JComponent.updateUI()
  - getUIClassID
```
public String getUIClassID()
```
    返回呈现此组件的L＆F类的名称。
    
    重写：
    
    getUIClassID在 JComponent
    
    结果
    
    字符串“ComboBoxUI”
    
    另请参见：
    
    JComponent.getUIClassID() ， UIDefaults.getUI(javax.swing.JComponent)
  - getUI
```
public ComboBoxUI getUI()
```
    返回渲染此组件的L＆F对象。
    
    结果
    
    呈现此组件的ComboBoxUI对象
  - setModel
```
public void setModel(ComboBoxModel<E> aModel)
```
    设置 JComboBox用于获取项目列表的数据模型。
    
    参数
    
    aModel -在 ComboBoxModel ，提供显示的项列表
  - getModel
```
public ComboBoxModel<E> getModel()
```
    返回当前使用的数据模型 JComboBox 。
    
    结果
    
    该 ComboBoxModel ，提供显示的项列表
  - setLightWeightPopupEnabled
```
public void setLightWeightPopupEnabled(boolean aFlag)
```
    设置lightWeightPopupEnabled属性，其中提供了一个提示是否应该使用轻量级Component来包含JComboBox ，而重量级Component （如Panel或Window 。轻量级与重量级的决定最终达到JComboBox 。轻量级的窗口比重型窗口更有效率，但轻量级和重型组件在GUI中不能很好的混合。如果您的应用程序混合轻量级和重量级组件，则应禁用轻量级弹出窗口。 lightWeightPopupEnabled属性的默认值为true ，除非外观和外观另有规定。一些看起来和感觉总是使用重量级的弹出窗口，无论这个属性的价值。
    请参阅文章Mixing Heavy and Light Components此方法触发属性更改事件。
    
    参数
    
    aFlag - 如果 true ，需要轻量级弹出窗口
  - isLightWeightPopupEnabled
```
public boolean isLightWeightPopupEnabled()
```
    获取 lightWeightPopupEnabled属性的值。
    
    结果
    
    该值为 lightWeightPopupEnabled属性
    
    另请参见：
    
    setLightWeightPopupEnabled(boolean)
  - setEditable
```
public void setEditable(boolean aFlag)
```
    确定JComboBox字段是否可编辑。可编辑的JComboBox允许用户键入字段或从列表中选择一个项目以初始化该字段，之后可以对其进行编辑。（编辑仅影响字段，列表项目保持不变。）不可编辑的JComboBox在该字段中显示所选项目，但无法修改选择项。
    
    参数
    
    aFlag - 一个布尔值，其中true表示该字段是可编辑的
  - isEditable
```
public boolean isEditable()
```
    如果JComboBox是可编辑的，则返回true。默认情况下，组合框不可编辑。
    
    结果
    
    如果 JComboBox是可编辑的，则为true，否则为false
  - setMaximumRowCount
```
public void setMaximumRowCount(int count)
```
    设置JComboBox显示的最大行数。如果模型中的对象数量大于count，组合框将使用滚动条。
    
    参数
    
    count - 一个整数，指定在使用滚动条之前在列表中显示的最大项目数
  - getMaximumRowCount
```
public int getMaximumRowCount()
```
    返回在没有滚动条的情况下组合框可以显示的最大项数
    
    结果
    
    一个整数，指定在使用滚动条之前在列表中显示的最大项目数
  - setRenderer
```
public void setRenderer(ListCellRenderer<? super E> aRenderer)
```
    设置绘制列表项目的渲染器和从JComboBox字段中的列表中选择的项目。如果JComboBox不可编辑，则使用渲染器。如果可编辑，编辑器用于渲染和编辑所选项目。
    默认渲染器显示字符串或图标。其他渲染器可以处理图形图像和复合项目。
    
    要显示所选项目， aRenderer.getListCellRendererComponent ，传递列表对象和索引-1。
    
    参数
    
    aRenderer - 显示所选项目的 ListCellRenderer
    
    另请参见：
    
    setEditor(javax.swing.ComboBoxEditor)
  - getRenderer
```
public ListCellRenderer<? super E> getRenderer()
```
    返回在 JComboBox字段中用于显示所选项目的渲染器。
    
    结果
    
    显示所选项目的 ListCellRenderer 。
  - setEditor
```
public void setEditor(ComboBoxEditor anEditor)
```
    设置用于在JComboBox字段中绘制和编辑所选项目的编辑器。仅当接收到JComboBox可编辑时才使用编辑器。如果不可编辑，组合框将使用渲染器来绘制所选项。
    
    参数
    
    anEditor - 显示所选项目的 ComboBoxEditor
    
    另请参见：
    
    setRenderer(javax.swing.ListCellRenderer<? super E>)
  - getEditor
```
public ComboBoxEditor getEditor()
```
    返回在 JComboBox字段中用于绘制和编辑所选项目的编辑器。
    
    结果
    
    显示所选项目的 ComboBoxEditor
  - setSelectedItem
```
public void setSelectedItem(Object anObject)
```
    将组合框显示区域中的选定项目设置为参数中的对象。如果anObject是在列表中，显示区显示anObject选择。
    如果anObject 不在列表中，并且组合框是不可编辑的，则不会更改当前选择。对于可编辑的组合框，选择将更改为anObject 。
    
    如果这是所选项目的变化，则添加到组合框中的ItemListener将通知一个或两个ItemEvent s。如果有当前选定的项目， ItemEvent将被触发，状态更改将为ItemEvent.DESELECTED 。如果anObject在列表中，当前未选择，那么ItemEvent将被触发，状态更改将为ItemEvent.SELECTED 。
    
    ActionListener添加到组合框将被通知一个ActionEvent当这个方法被调用。
    
    参数
    
    anObject - 要选择的列表对象; 使用null清除选择
  - getSelectedItem
```
public Object getSelectedItem()
```
    返回当前所选项目。
    如果组合框可编辑，则该值可能没有被添加到组合框addItem ， insertItemAt或数据构造。
    
    结果
    
    当前选中的对象
    
    另请参见：
    
    setSelectedItem(java.lang.Object)
  - setSelectedIndex
```
public void setSelectedIndex(int anIndex)
```
    选择索引号为 anIndex的项目。
    
    参数
    
    anIndex - 指定要选择的列表项的整数，其中0指定列表中的第一个项，-1表示不选择
    
    异常
    
    IllegalArgumentException - 如果 anIndex <-1或 anIndex大于或等于大小
  - getSelectedIndex
```
public int getSelectedIndex()
```
    返回列表中与给定项目匹配的第一个项目。如果JComboBox允许不在列表中的所选项目，则结果并不总是被定义。如果没有选定项目，或者用户指定了不在列表中的项目，则返回-1。
    
    结果
    
    一个指定当前选择的列表项的整数，其中0指定列表中的第一个项; 或者如果没有选择项目，或者当前选择的项目不在列表中，则为-1
  - getPrototypeDisplayValue
```
public E getPrototypeDisplayValue()
```
    返回“原型显示”值 - 用于计算显示高度和宽度的对象。
    
    结果
    
    的价值 prototypeDisplayValue属性
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    setPrototypeDisplayValue(E)
  - setPrototypeDisplayValue
```
public void setPrototypeDisplayValue(E prototypeDisplayValue)
```
    设置用于计算UI部分显示大小的原型显示值。
    如果指定了原型显示值，则通过使用原型显示值配置渲染器并获得其首选大小来计算组合框的首选大小。当组合框显示大量数据时，指定首选显示值通常很有用。如果没有指定原型显示值，则必须为模型中的每个值配置渲染器和获取的首选尺寸，这可能相对昂贵。
    
    参数
    
    prototypeDisplayValue -
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    getPrototypeDisplayValue()
  - addItem
```
public void addItem(E item)
```
    将项目添加到项目列表。该方法仅在JComboBox使用可变数据模型时有效。
    警告：如果添加重复的String对象，可能会出现焦点和键盘导航问题。解决方法是添加新对象而不是String对象，并确保定义了toString（）方法。例如：
```
  comboBox.addItem(makeObj("Item 1"));
   comboBox.addItem(makeObj("Item 1"));
   ...
   private Object makeObj(final String item)  {
     return new Object() { public String toString() { return item; } };
   } 
```
    参数
    
    item - 要添加到列表中的项目
    
    另请参见：
    
    MutableComboBoxModel
  - insertItemAt
```
public void insertItemAt(E item,
                         int index)
```
    在给定索引的项目列表中插入项目。该方法仅在JComboBox使用可变数据模型时有效。
    
    参数
    
    item - 要添加到列表的项目
    
    index - 指定要添加项目的位置的整数
    
    另请参见：
    
    MutableComboBoxModel
  - removeItem
```
public void removeItem(Object anObject)
```
    从项目列表中删除一个项目。此方法仅在JComboBox使用可变数据模型时有效。
    
    参数
    
    anObject - 要从项目列表中删除的对象
    
    另请参见：
    
    MutableComboBoxModel
  - removeItemAt
```
public void removeItemAt(int anIndex)
```
    anIndex删除该项目此方法仅在 JComboBox使用可变数据模型时有效。
    
    参数
    
    anIndex - 一个int指定要删除的项目的索引，其中0表示列表中的第一个项目
    
    另请参见：
    
    MutableComboBoxModel
  - removeAllItems
```
public void removeAllItems()
```
    从项目列表中删除所有项目。
  - showPopup
```
public void showPopup()
```
    导致组合框显示其弹出窗口。
    
    另请参见：
    
    setPopupVisible(boolean)
  - hidePopup
```
public void hidePopup()
```
    导致组合框关闭其弹出窗口。
    
    另请参见：
    
    setPopupVisible(boolean)
  - setPopupVisible
```
public void setPopupVisible(boolean v)
```
    设置弹出窗口的可见性。
  - isPopupVisible
```
public boolean isPopupVisible()
```
    确定弹出窗口的可见性。
    
    结果
    
    如果弹出窗口可见，则返回true，否则返回false
  - addItemListener
```
public void addItemListener(ItemListener aListener)
```
    添加一个ItemListener 。
    aListener将在所选项目更改时收到一个或两个ItemEvent 。
    
    Specified by:
    
    addItemListener在接口 ItemSelectable
    
    参数
    
    aListener - 要通知的 ItemListener
    
    另请参见：
    
    setSelectedItem(java.lang.Object)
  - removeItemListener
```
public void removeItemListener(ItemListener aListener)
```
    删除一个 ItemListener 。
    
    Specified by:
    
    removeItemListener在接口 ItemSelectable
    
    参数
    
    aListener - 要删除的 ItemListener
    
    另请参见：
    
    ItemEvent
  - getItemListeners
```
public ItemListener[] getItemListeners()
```
    返回使用addItemListener（）添加到此JComboBox的所有 ItemListener的数组。
    
    结果
    
    如果没有添加任何侦听器，则添加所有 ItemListener s或一个空数组
    
    从以下版本开始：
    
    1.4
  - addActionListener
```
public void addActionListener(ActionListener l)
```
    添加一个ActionListener 。
    ActionListener将在ActionEvent时收到ActionEvent 。如果组合框是可编辑的，则编辑停止时将会触发ActionEvent 。
    
    参数
    
    l - 要通知的 ActionListener
    
    另请参见：
    
    setSelectedItem(java.lang.Object)
  - removeActionListener
```
public void removeActionListener(ActionListener l)
```
    删除 ActionListener 。
    
    参数
    
    l - 要删除的 ActionListener
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    返回使用addActionListener（）添加到此JComboBox的所有 ActionListener的数组。
    
    结果
    
    所有的 ActionListener加入一个空数组，如果没有添加侦听器，
    
    从以下版本开始：
    
    1.4
  - addPopupMenuListener
```
public void addPopupMenuListener(PopupMenuListener l)
```
    添加一个PopupMenu监听器，它将从组合框的弹出窗口中收听通知消息。
    对于Java附带的所有标准外观和感觉，组合框的弹出列表部分实现为JPopupMenu 。自定义外观可能无法实现，因此不会收到通知。
    
    参数
    
    l - 要添加的 PopupMenuListener
    
    从以下版本开始：
    
    1.4
  - removePopupMenuListener
```
public void removePopupMenuListener(PopupMenuListener l)
```
    删除 PopupMenuListener 。
    
    参数
    
    l - 要删除的 PopupMenuListener
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    addPopupMenuListener(javax.swing.event.PopupMenuListener)
  - getPopupMenuListeners
```
public PopupMenuListener[] getPopupMenuListeners()
```
    返回使用addPopupMenuListener（）添加到此JComboBox的所有 PopupMenuListener的数组。
    
    结果
    
    添加了所有 PopupMenuListener或者如果没有添加任何监听器，则为空数组
    
    从以下版本开始：
    
    1.4
  - firePopupMenuWillBecomeVisible
```
public void firePopupMenuWillBecomeVisible()
```
    通知PopupMenuListener s组合框的弹出部分将变得可见。
    这个方法是公开的，但不应该被UI委托以外的任何东西调用。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    addPopupMenuListener(javax.swing.event.PopupMenuListener)
  - firePopupMenuWillBecomeInvisible
```
public void firePopupMenuWillBecomeInvisible()
```
    通知PopupMenuListener s组合框的弹出部分变得不可见。
    这个方法是公开的，但不应该被UI委托以外的任何东西调用。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    addPopupMenuListener(javax.swing.event.PopupMenuListener)
  - firePopupMenuCanceled
```
public void firePopupMenuCanceled()
```
    通知PopupMenuListener s组合框的弹出部分已被取消。
    这个方法是公开的，但不应该被UI委托以外的任何东西调用。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    addPopupMenuListener(javax.swing.event.PopupMenuListener)
  - setActionCommand
```
public void setActionCommand(String aCommand)
```
    设置应该包含在发送到action监听器的事件中的action命令。
    
    参数
    
    aCommand - 一个包含发送到动作侦听器的“命令”的字符串; 同样的听众可以根据接收到的命令来做不同的事情
  - getActionCommand
```
public String getActionCommand()
```
    返回发送到动作侦听器的事件中包含的动作命令。
    
    结果
    
    该字符串包含发送到动作侦听器的“命令”。
  - setAction
```
public void setAction(Action a)
```
    为Action设置ActionEvent来源。新Action替换任何以前设置Action但不影响ActionListeners与单独添加addActionListener 。如果Action已经是ActionEvent的注册ActionListener为ActionEvent ，则不会重新注册。
    设置Action会导致立即更改Swing Components Supporting Action中描述的所有属性。随后，组合框的属性将自动更新为Action的属性更改。
    
    此方法使用其他三种方法来设置和帮助跟踪Action的属性值。它使用configurePropertiesFromAction方法立即更改组合框的属性。要跟踪Action的属性值的更改，此方法注册PropertyChangeListener返回的createActionPropertyChangeListener 。默认PropertyChangeListener调用actionPropertyChanged方法时的属性Action变化。
    
    参数
    
    a - Action为 JComboBox ，或 null 。
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    Action ， getAction() ， configurePropertiesFromAction(javax.swing.Action) ， createActionPropertyChangeListener(javax.swing.Action) ， actionPropertyChanged(javax.swing.Action, java.lang.String)
  - getAction
```
public Action getAction()
```
    返回当前设置的 Action为 ActionEvent源，或 null如果没有设置 Action 。
    
    结果
    
    Action为这ActionEvent源码; 或null
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    Action ， setAction(javax.swing.Action)
  - configurePropertiesFromAction
```
protected void configurePropertiesFromAction(Action a)
```
    设置此组合框上的属性，以匹配指定的Action中的Action 。有关此设置的属性的更多详细信息，请参阅Swing Components Supporting Action 。
    
    参数
    
    a - Action从哪个获取属性，或 null
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    Action ， setAction(javax.swing.Action)
  - createActionPropertyChangeListener
```
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
```
    创建并返回一个PropertyChangeListener ，负责监听来自指定的变化Action和更新相应的属性。
    警告：如果你这个子类不创建一个匿名的内部类。如果你一生的组合框将被绑定到Action 。
    
    参数
    
    a - 组合框的动作
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    Action ， setAction(javax.swing.Action)
  - actionPropertyChanged
```
protected void actionPropertyChanged(Action action,
                                     String propertyName)
```
    响应关联操作中的属性更改更新组合框的状态。此方法被调用的PropertyChangeListener从返回createActionPropertyChangeListener 。子类通常不需要调用它。支持额外Action Action子类应该覆盖此和configurePropertiesFromAction 。
    有关此方法设置的属性的列表，请参阅Swing Components Supporting Action的表。
    
    参数
    
    action - 与此组合框相关 Action Action
    
    propertyName - 更改的属性的名称
    
    从以下版本开始：
    
    1.6
    
    另请参见：
    
    Action ， configurePropertiesFromAction(javax.swing.Action)
  - fireItemStateChanged
```
protected void fireItemStateChanged(ItemEvent e)
```
    通知所有在此事件类型上通知有兴趣的听众。
    
    参数
    
    e - 感兴趣的事件
    
    另请参见：
    
    EventListenerList
  - fireActionEvent
```
protected void fireActionEvent()
```
    通知所有在此事件类型上通知有兴趣的听众。
    
    另请参见：
    
    EventListenerList
  - selectedItemChanged
```
protected void selectedItemChanged()
```
    这种受保护的方法是具体的实现。不要直接访问或覆盖。
  - getSelectedObjects
```
public Object[] getSelectedObjects()
```
    返回一个包含所选项目的数组。该方法是为了与ItemSelectable兼容而ItemSelectable 。
    
    Specified by:
    
    getSelectedObjects在接口 ItemSelectable
    
    结果
    
    一个包含一个元素的 Objects数组 - 所选项
  - actionPerformed
```
public void actionPerformed(ActionEvent e)
```
    这种方法是公共的，作为实现的副作用。不要打电话或覆盖。
    
    Specified by:
    
    actionPerformed在接口 ActionListener
  - contentsChanged
```
public void contentsChanged(ListDataEvent e)
```
    这种方法是公共的，作为实现的副作用。不要打电话或覆盖。
    
    Specified by:
    
    contentsChanged在界面 ListDataListener
    
    参数
    
    e - ListDataEvent ListDataEvent封装事件信息
  - intervalAdded
```
public void intervalAdded(ListDataEvent e)
```
    这种方法是公共的，作为实现的副作用。不要打电话或覆盖。
    
    Specified by:
    
    intervalAdded在接口 ListDataListener
    
    参数
    
    e - ListDataEvent ListDataEvent封装事件信息
  - intervalRemoved
```
public void intervalRemoved(ListDataEvent e)
```
    这种方法是公共的，作为实现的副作用。不要打电话或覆盖。
    
    Specified by:
    
    intervalRemoved在界面 ListDataListener
    
    参数
    
    e -一个 ListDataEvent封装事件信息
  - selectWithKeyChar
```
public boolean selectWithKeyChar(char keyChar)
```
    选择与指定键盘字符相对应的列表项，如果存在与该字符相对应的项，则返回true。否则返回false。
    
    参数
    
    keyChar - 一个char，通常这是用户键入的键盘键
  - setEnabled
```
public void setEnabled(boolean b)
```
    启用组合框，以便可以选择项目。当禁用组合框时，无法选择项目，无法在其字段中输入值（如果可编辑）。
    
    重写：
    
    setEnabled在 JComponent
    
    参数
    
    b - 一个布尔值，其中true使组件和false禁用它
    
    另请参见：
    
    Component.isEnabled() ， Component.isLightweight()
  - configureEditor
```
public void configureEditor(ComboBoxEditor anEditor,
                            Object anItem)
```
    用指定的项目初始化编辑器。
    
    参数
    
    anEditor - 在组合框字段中显示列表项的 ComboBoxEditor ，允许编辑
    
    anItem - 要在字段中显示和编辑的对象
  - processKeyEvent
```
public void processKeyEvent(KeyEvent e)
```
    手柄KeyEvent s，寻找Tab键。如果找到Tab键，弹出窗口关闭。
    
    重写：
    
    processKeyEvent在 JComponent
    
    参数
    
    e - KeyEvent按下的键盘键的 KeyEvent
    
    另请参见：
    
    KeyEvent ， KeyListener ， KeyboardFocusManager ， DefaultKeyboardFocusManager ， Component.processEvent(java.awt.AWTEvent) ， Component.dispatchEvent(java.awt.AWTEvent) ， Component.addKeyListener(java.awt.event.KeyListener) ， Component.enableEvents(long) ， Component.isShowing()
  - setKeySelectionManager
```
public void setKeySelectionManager(JComboBox.KeySelectionManager aManager)
```
    设置将键盘字符转换为列表选择的对象。通常，具有匹配的第一个字符的第一个选择将成为所选项。
  - getKeySelectionManager
```
public JComboBox.KeySelectionManager getKeySelectionManager()
```
    返回列表的密钥选择管理器。
    
    结果
    
    目前 KeySelectionManager使用的 KeySelectionManager
  - getItemCount
```
public int getItemCount()
```
    返回列表中的项目数。
    
    结果
    
    一个等于列表中项目数的整数
  - getItemAt
```
public E getItemAt(int index)
```
    返回指定索引处的列表项。如果index超出范围（小于零或大于或等于大小），它将返回null 。
    
    参数
    
    index - 表示列表位置的整数，第一个项目从零开始
    
    结果
    
    该列表位置的项目; 如果超出范围， null
  - createDefaultKeySelectionManager
```
protected JComboBox.KeySelectionManager createDefaultKeySelectionManager()
```
    返回默认密钥选择管理器的一个实例。
    
    结果
    
    该 KeySelectionManager目前使用的 KeySelectionManager
    
    另请参见：
    
    setKeySelectionManager(javax.swing.JComboBox.KeySelectionManager)
  - paramString
```
protected String paramString()
```
    返回此JComboBox的字符串表示JComboBox 。该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是null 。
    
    重写：
    
    paramString在 JComponent
    
    结果
    
    这个 JComboBox的字符串表示 JComboBox
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此JComboBox关联的AccessibleContext。对于组合框，AccessibleContext采用AccessibleJComboBox的形式。如有必要，将创建一个新的AccessibleJComboBox实例。
    
    Specified by:
    
    getAccessibleContext在界面 Accessible
    
    重写：
    
    getAccessibleContext在 Component
    
    结果
    
    一个AccessibleJComboBox，用作这个JComboBox的AccessibleContext

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class JComboBox<E>

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

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

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

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

字段详细信息

dataModel

renderer

editor

maximumRowCount

isEditable

keySelectionManager

actionCommand

lightWeightPopupEnabled

selectedItemReminder

构造方法详细信息

JComboBox

JComboBox

JComboBox

JComboBox

方法详细信息

installAncestorListener

setUI

updateUI

getUIClassID

getUI

setModel

getModel

setLightWeightPopupEnabled

isLightWeightPopupEnabled

setEditable

isEditable

setMaximumRowCount

getMaximumRowCount

setRenderer

getRenderer

setEditor

getEditor

setSelectedItem

getSelectedItem

setSelectedIndex

getSelectedIndex

getPrototypeDisplayValue

setPrototypeDisplayValue

addItem

insertItemAt

removeItem

removeItemAt

removeAllItems

showPopup

hidePopup

setPopupVisible

isPopupVisible

addItemListener

removeItemListener

getItemListeners

addActionListener

removeActionListener

getActionListeners

addPopupMenuListener

removePopupMenuListener

getPopupMenuListeners

firePopupMenuWillBecomeVisible

firePopupMenuWillBecomeInvisible

firePopupMenuCanceled

setActionCommand

getActionCommand

setAction

getAction

configurePropertiesFromAction