Java开发笔记（一百三十一）Swing的列表框

时间 2019-11-10

原文原文链接

前面介绍了选择框的用法，当时为了方便用户勾勾点点，不管是复选框仍是单选按钮，通通把全部选项都摆在界面上。假若只有两三个选项还好办，要是选项数量变多好比超过五个，这么多的选择框一齐在界面罗列，不光程序员排版费劲，用户瞅着也容易眼花。鉴于这些选择框每每选完一次就了事，可贵有从新选择第二次的机会，于是在界面上所有铺开这些选择框实属浪费。更好的作法是在选择的时候才展开全部选项，选完以后就缩回只显示选中的那一项，一伸一缩之间才能充分利用有限的屏幕界面。
以单选按钮的组合为例，许多个单选按钮只能选择其中一个，这种状况就很适合展开与收缩的处理逻辑。Swing给该场景提供了专门的下拉框控件JComboBox，为了往下拉框塞进各个选项，还须要将它与下拉框模型DefaultComboBoxModel搭配使用才行。下拉框具体的调用过程分为下列三个步骤：
一、建立一个下拉框模型，并调用模型对象的addElement方法依次添加每一个选项；
二、建立一个下拉框控件，注意要在JComboBox的构造方法中填入第一步的模型对象；
三、调用下拉框对象的addItemListener方法给它添加一个点击监听器，每当用户在下拉面板中选择某一项，都会触发监听器的itemStateChanged方法。此时便可经过下拉框对象的getSelectedIndex方法得到选中项的序号，还可经过getSelectedItem方法得到选中项的对象。
下面是利用JComboBox实现下拉选择功能的代码例子：html

		JPanel panelTop = new JPanel(); // 建立顶部面板
		// 建立一个下拉框模型
		DefaultComboBoxModel<String> comboModel = new DefaultComboBoxModel<String>();
		comboModel.addElement("鱼香肉丝饭"); // 往下拉模型中添加元素
		comboModel.addElement("香菇滑鸡饭"); // 往下拉模型中添加元素
		comboModel.addElement("黑椒牛排饭"); // 往下拉模型中添加元素
		comboModel.addElement("梅菜扣肉饭"); // 往下拉模型中添加元素
		comboModel.addElement("糖醋里脊饭"); // 往下拉模型中添加元素
		comboModel.addElement("红烧排骨饭"); // 往下拉模型中添加元素
		comboModel.addElement("台式卤肉饭"); // 往下拉模型中添加元素
		JComboBox<String> comboBox = new JComboBox<String>(comboModel); // 建立一个下拉框
		panelTop.add(comboBox); // 在顶部面板上添加下拉框
		frame.add(panelTop, BorderLayout.NORTH); // 把顶部面板添加到窗口的北边（上方）
		comboBox.setEditable(false); // 设置下拉框可否编辑。默认不容许编辑
		comboBox.addItemListener(new ItemListener() { // 给下拉框添加一个点击监听器
			public void itemStateChanged(ItemEvent e) { // 下拉框被选择
				// 获取下拉框内选中项的序号及其描述
				// getSelectedIndex方法可得到选中项的序号，getSelectedItem方法可得到选中项的对象
				String desc = String.format("您点了第%d项，套餐名称是%s", 
						comboBox.getSelectedIndex(), comboBox.getSelectedItem().toString());
				label.setText(desc); // 在标签上显示当前选中的文本项
			}
		});

运行上面的下拉框代码，弹出以下图所示的窗口界面，可见一开始下拉框只占据长条般的空间，而且默认展现第一个选项。程序员

接着单击下拉框的长条区域，界面会向下弹出包含全部选项的下拉面板，选中面板上的某一项后，下拉面板消失不见，同时长条框内的文字变成了刚才选中项的文本。选择先后的窗口界面分别如如下两张图所示。orm

虽然下拉框比起单选按钮组合要节省屏幕空间，但它的实现机制也致使了以下几点局限：
一、下拉框只实现了单选功能，不支持多选功能，没法同时选择好几个选项；
二、从新选择之时，要先点一下长条区域，才能在弹出的下拉面板中挑选新的选项，简简单单的选择操做也花费了两个步骤，甚不经济；
以上两点局限的原由，皆来源于下拉面板的弹出与缩回机制，每次都要单击长条框才会弹出下拉面板，单击选中某一项后又会自动关闭下拉面板，正是这种单次点击单次响应的行为决定了下拉框只能用于单选操做，而不能用于多选操做。要想实现多选功能，还得将全部选项铺开展现，就像文件列表那样，用户才能按下Ctrl键逐个选中，或者按下Shift键选择一段连续的数个选项。这种平铺直叙全部选项的控件也叫列表框，对应于Swing中的JList类型，列表框的用法相似下拉框，它的调用过程依然分为如下三个步骤：
一、建立一个列表框模型DefaultListModel，并调用模型对象的addElement方法依次添加每一个选项；
二、建立一个列表框控件，注意要在JList的构造方法中填入第一步的模型对象；
三、调用列表框对象的addListSelectionListener方法给它添加一个点击监听器，每当用户单击列表框中的某一项，都会触发监听器的valueChanged方法。此时便可经过列表框对象的getSelectedIndex方法得到选中项的序号，经过getSelectedValue方法得到选中项的值，还能经过getSelectedValuesList方法得到全部选中项的值列表。
下面是利用JList实现屡次选择功能的代码例子：htm

		JPanel panelLeft = new JPanel(); // 建立左边面板
		// 建立一个列表框模型
		DefaultListModel<String> listModel = new DefaultListModel<String>();
		listModel.addElement("鱼香肉丝饭"); // 往列表模型中添加元素
		listModel.addElement("香菇滑鸡饭"); // 往列表模型中添加元素
		listModel.addElement("黑椒牛排饭"); // 往列表模型中添加元素
		listModel.addElement("梅菜扣肉饭"); // 往列表模型中添加元素
		listModel.addElement("糖醋里脊饭"); // 往列表模型中添加元素
		listModel.addElement("红烧排骨饭"); // 往列表模型中添加元素
		listModel.addElement("台式卤肉饭"); // 往列表模型中添加元素
		JList<String> listBox = new JList<String>(listModel); // 建立一个列表框
		panelLeft.add(listBox); // 在顶部面板上添加列表框
		frame.add(panelLeft, BorderLayout.WEST); // 把顶部面板添加到窗口的西边（左侧）
		listBox.addListSelectionListener(new ListSelectionListener() { // 给列表框添加一个点击监听器
			public void valueChanged(ListSelectionEvent arg0) { // 列表框被选择
				// 获取列表框内选中项的序号及其描述
				// getSelectedIndex方法可得到选中项的序号，getSelectedValue方法可得到选中项的值
				String desc = String.format("您点了第%d项，套餐名称是%s", 
						listBox.getSelectedIndex(), listBox.getSelectedValue());
				labelBottom.setText(desc); // 在标签上显示当前选中的文本项
				String total = "<html>您已选择的套餐列表以下：<br>";
				// 获取列表框内的全部选择项，并拼接html格式的描述串
				for (String str : listBox.getSelectedValuesList()) {
					total = String.format("%s<center>%s</center>", total, str);
				}
				total += "</html>";
				labelCenter.setText(total); // 在标签上显示全部选中的文本项
			}
		});

运行以上的列表框代码，弹出以下图所示的窗口界面，可见列表框一开始就展现了全部选项。对象

而后按住Ctrl键，从下往上依次单击选中第七项、第五项、第三项、第一项，每次单击以后的界面效果分别如如下四张图片所示。blog

从这些效果图能够看到，在按住Ctrl键的时候，列表框能够实现多选功能；未按住Ctrl键的时候，列表框变成实现单选功能。图片

更多Java技术文章参见《Java开发笔记（序）章节目录》开发