java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JComboBox
public class JComboBox
将按钮或可编辑字段与下拉列表组合的组件。用户可以从下拉列表中选择值,下拉列表在用户请求时显示。如果使组合框处于可编辑状态,则组合框将包括用户可在其中键入值的可编辑字段。
警告:Swing 不是线程安全的。有关更多信息,请参阅 Swing's Threading Policy。
警告:此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder
。
有关更多信息,请参阅 The Java Tutorial 中的 How to Use Combo Boxes 一节。
嵌套类摘要 | |
---|---|
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 属性重置为当前外观的值。 |
从类 java.awt.Container 继承的方法 |
---|
ad
|