JComboBox 组件被称为组合框或者下拉列表框,它将所有选项折叠收藏在一起,**默认显示的是第一个**添加的选项。当用户单击组合框时,会出现下拉式的选择列表,用户可以从中选择其中一项并显示。
JComboBox 组合框组件分为可编辑和不可编辑两种形式,对于不可编辑的组合框,用户只能在现有的选项中选择;而对于可编辑的组合框,用户既可以在现有的选项中选择,也可以自己输入新的内容。需要注意的是,自己输入的内容只能作为当前项显示,并不会添加到组合框的选项列表中。下表列举了 JComboBox 类的常用构造方法。
方法描述 | 功能说明 |
---|---|
JComboBox() | 创建一个没有可选项的组合框 |
JComboBox(Object[] items) | 创建一个组合框,将 Object 数组中的元素作为组合框的下拉列表选项 |
JComboBox(Vector items) | 创建一个组合框,将 Vector 集合中的元素作为组合框的下拉列表选项 |
在使用 JComboBox 时,需要用到它的一些常用方法,如下表所示。
方法描述 | 功能说明 |
---|---|
void addItem(Object anObject) | 为组合框添加选项 |
void insertItemAt(Object anObject, int index) | 在指定的引索处插入选项 |
Object getItemAt(int index) | 返回指定引索处选项,第一个选项的引索为 0 |
int getItemCount() | 返回组合框中选项的数目 |
Object getSelectedItem() | 返回当前所选项 |
void removeAllItems() | 删除组合框中所有的选项 |
void removeItem(Object object) | 从组合框中删除指定选项 |
void removeItemAt(int index) | 移除指定引索处的选项 |
void setEditable(boolean aFlag) | 设置组合框的选项是否可编辑,aFlag 为 true 则可编辑,反之则不可编辑 |
通过上面两个表简单认识了 JComboBox 类的构造方法和常用方法,接下来通过一个案例来演示一下该组件的具体用法,如下所示。
import java.awt.BorderLayout;
import java.awt.event.*;
import javax.swing.*;
public class example21 extends JFrame{
private JComboBox comboBox; //声明一个 JComboBox 组合框
private JTextField field; //声明一个 JTextField 文本框
public example21() {
JPanel panel = new JPanel(); //创建一个 JPanel 面板
comboBox = new JComboBox();
//为组合框添加选项
comboBox.addItem("请选择城市");
comboBox.addItem("北京");
comboBox.addItem("天津");
comboBox.addItem("南京");
comboBox.addItem("上海");
comboBox.addItem("重庆");
//为组合框添加事件监听器
comboBox.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
// TODO Auto-generated method stub
String item = (String) comboBox.getSelectedItem();
if ("请选择城市".equals(item)) {
field.setText("");
}else {
field.setText("您选择的城市是:" + item);
}
}
});
field = new JTextField(20);
panel.add(comboBox); //在面板中添加组合框
panel.add(field); //在面板中添加文本框
//在内容面板中添加 JPanel 面板
this.add(panel, BorderLayout.NORTH);
this.setSize(350, 100);
this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
this.setVisible(true);
}
public static void main(String[] args) {
new example21();
}
}
运行程序,在窗体中又可选择的组合框,生成的窗体如下所示。
上述代码块中,首先定义了一个继承自 JFrame 的 example21 类,该类默认使用的是 BorderLayout 布局管理器。在窗口的 NORTH 区域中,放置了一个 JPanel 面板 panel,它里面有两个组件,一个是 JComboBox 组合框 comboBox,一个是 JTextField 文本框 field。然后为 JComboBox 组合框添加了一个事件监听器,在 actionPerformed()方法中,通过调用 comboBox 的 getSelectedItem()方法获得用户所选的 item。如果 item 为城市名,则调用 field 的setText(item)方法将城市名显示在文本框中;如果 item 为“请选择城市”,则将文本框的内容清空。