JComboBox (Java Platform SE 6)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
类 JComboBox

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JComboBox

所有已实现的接口：: ActionListener, ImageObserver, ItemSelectable, MenuContainer, Serializable, EventListener, Accessible, ListDataListener

public class JComboBox
extends JComponent

implements ItemSelectable, ListDataListener, ActionListener, Accessible
extends JComponent
implements ItemSelectable, ListDataListener, ActionListener, Accessible

将按钮或可编辑字段与下拉列表组合的组件。用户可以从下拉列表中选择值，下拉列表在用户请求时显示。如果使组合框处于可编辑状态，则组合框将包括用户可在其中键入值的可编辑字段。

警告：Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

有关更多信息，请参阅 The Java Tutorial 中的 How to Use Combo Boxes 一节。

另请参见：: ComboBoxModel, DefaultComboBoxModel

嵌套类摘要
`protected class`	`JComboBox.AccessibleJComboBox` 此类实现 `JComboBox` 类的可访问性支持。
`static interface`	`JComboBox.KeySelectionManager` 定义 `KeySelectionManager` 的接口。

从类 javax.swing.JComponent 继承的嵌套类/接口
`JComponent.AccessibleJComponent`

从类 java.awt.Container 继承的嵌套类/接口
`Container.AccessibleAWTContainer`

从类 java.awt.Component 继承的嵌套类/接口
`Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy`

字段摘要
`protected String`	`actionCommand` 此受保护字段是特定于实现的。
`protected ComboBoxModel`	`dataModel` 此受保护字段是特定于实现的。
`protected ComboBoxEditor`	`editor` 此受保护字段是特定于实现的。
`protected boolean`	`isEditable` 此受保护字段是特定于实现的。
`protected JComboBox.KeySelectionManager`	`keySelectionManager` 此受保护字段是特定于实现的。
`protected boolean`	`lightWeightPopupEnabled` 此受保护字段是特定于实现的。
`protected int`	`maximumRowCount` 此受保护字段是特定于实现的。
`protected ListCellRenderer`	`renderer` 此受保护字段是特定于实现的。
`protected Object`	`selectedItemReminder` 此受保护字段是特定于实现的。

从类 javax.swing.JComponent 继承的字段
`accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW`

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

构造方法摘要
`JComboBox()` 创建具有默认数据模型的 `JComboBox`。
`JComboBox(ComboBoxModel aModel)` 创建一个 `JComboBox`，其项取自现有的 `ComboBoxModel`。
`JComboBox(Object[] items)` 创建包含指定数组中的元素的 `JComboBox`。
`JComboBox(Vector<?> items)` 创建包含指定 Vector 中的元素的 `JComboBox`。

方法摘要
`void`	`actionPerformed(ActionEvent e)` 此方法由于实现的副作用而存在的公共方法。
`protected void`	`actionPropertyChanged(Action action, String propertyName)` 更新组合框的状态以响应关联动作中的属性更改。
`void`	`addActionListener(ActionListener l)` 添加 `ActionListener`。
`void`	`addItem(Object anObject)` 为项列表添加项。
`void`	`addItemListener(ItemListener aListener)` 添加 `ItemListener`。
`void`	`addPopupMenuListener(PopupMenuListener l)` 添加 `PopupMenu` 侦听器，该侦听器将侦听取自组合框弹出部分的通知消息。
`void`	`configureEditor(ComboBoxEditor anEditor, Object anItem)` 利用指定项初始化编辑器。
`protected void`	`configurePropertiesFromAction(Action a)` 在此组合框上设置属性以匹配指定 `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` 组合框的弹出部分已被取消。
`void`	`firePopupMenuWillBecomeInvisible()` 通知 `PopupMenuListener` 组合框的弹出部分已变得不可见。
`void`	`firePopupMenuWillBecomeVisible()` 通知 `PopupMenuListener` 组合框的弹出部分将变得可见。
`AccessibleContext`	`getAccessibleContext()` 获取与此 JComboBox 关联的 AccessibleContext。
`Action`	`getAction()` 返回此 `ActionEvent` 源当前设置的 `Action`，如果没有设置任何 `Action`，则返回 `null`。
`String`	`getActionCommand()` 返回发送到动作侦听器的事件中包括的动作命令。
`ActionListener[]`	`getActionListeners()` 返回使用 addActionListener() 添加到此 JComboBox 的所有 `ActionListener` 组成的数组。
`ComboBoxEditor`	`getEditor()` 返回用于绘制和编辑 `JComboBox` 字段中所选项的编辑器。
`Object`	`getItemAt(int index)` 返回指定索引处的列表项。
`int`	`getItemCount()` 返回列表中的项数。
`ItemListener[]`	`getItemListeners()` 返回使用 addItemListener() 添加到此 JComboBox 中的所有 `ItemListener` 组成的数组。
`JComboBox.KeySelectionManager`	`getKeySelectionManager()` 返回列表的键选择管理器。
`int`	`getMaximumRowCount()` 返回组合框不使用滚动条可以显示的最大项数
`ComboBoxModel`	`getModel()` 返回 `JComboBox` 当前使用的数据模型。
`PopupMenuListener[]`	`getPopupMenuListeners()` 返回利用 addPopupMenuListener() 添加到此 JComboBox 的所有 `PopupMenuListener` 组成的数组。
`Object`	`getPrototypeDisplayValue()` 返回“原型显示”值，即用于计算显示高度和宽度的 Object。
`ListCellRenderer`	`getRenderer()` 返回用于显示 `JComboBox` 字段中所选项的渲染器。
`int`	`getSelectedIndex()` 返回列表中与给定项匹配的第一个选项。
`Object`	`getSelectedItem()` 返回当前所选项。
`Object[]`	`getSelectedObjects()` 返回包含所选项的数组。
`ComboBoxUI`	`getUI()` 返回呈现此组件的 L&F 对象。
`String`	`getUIClassID()` 返回呈现此组件的 L&F 类的名称。
`void`	`hidePopup()` 促使组合框关闭其弹出窗口。
`void`	`insertItemAt(Object anObject, 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` 的字符串表示形式。
`void`	`processKeyEvent(KeyEvent e)` 处理 `KeyEvent`，查找 Tab 键。
`void`	`removeActionListener(ActionListener l)` 移除 `ActionListener`。
`void`	`removeAllItems()` 从项列表中移除所有项。
`void`	`removeItem(Object anObject)` 从项列表中移除项。
`void`	`removeItemAt(int anIndex)` 移除 `anIndex` 处的项。
`void`	`removeItemListener(ItemListener aListener)` 移除 `ItemListener`。
`void`	`removePopupMenuListener(PopupMenuListener l)` 移除 `PopupMenuListener`。
`protected void`	`selectedItemChanged()` 此受保护方法是特定于实现的。
`boolean`	`selectWithKeyChar(char keyChar)` 如果存在与指定键盘字符相对应的项，则选择该列表项并返回 true。
`void`	`setAction(Action a)` 设置 `ActionEvent` 源的 `Action`。
`void`	`setActionCommand(String aCommand)` 设置发送到动作侦听器的事件中应该包括的动作命令。
`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`（如 `Panel` 或 `Window`）还是轻量级 `Component` 来包含 `JComboBox`。
`void`	`setMaximumRowCount(int count)` 设置 `JComboBox` 显示的最大行数。
`void`	`setModel(ComboBoxModel aModel)` 设置 `JComboBox` 用于获取项列表的数据模型。
`void`	`setPopupVisible(boolean v)` 设置弹出窗口的可见性。
`void`	`setPrototypeDisplayValue(Object prototypeDisplayValue)` 设置用于计算 UI 部分的显示大小的原型显示值。
`void`	`setRenderer(ListCellRenderer aRenderer)` 设置渲染器，该渲染器用于绘制列表项和从 JComboBox 字段的列表中选择的项。
`void`	`setSelectedIndex(int anIndex)` 选择索引 `anIndex` 处的项。
`void`	`setSelectedItem(Object anObject)` 将组合框显示区域中所选项设置为参数中的对象。
`void`	`setUI(ComboBoxUI ui)` 设置呈现此组件的 L&F 对象。
`void`	`showPopup()` 促使组合框显示其弹出窗口。
`void`	`updateUI()` 将 UI 属性重置为当前外观的值。

从类 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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

从类 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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

从类 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, transferFocusBackward, transferFocusDownCycle, validate, validateTree

从类 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, transferFocusBackward, transferFocusDownCycle, validate, validateTree

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

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

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

字段详细信息