JComboBox (Java 2 Platform SE 6)

概觀

軟體套件

類別

使用

階層樹

已過時

索引

說明

Java^TM 2 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`

欄位詳細資訊