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 stubString 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 为“请选择城市”,则将文本框的内容清空。
