图形化用户界面（9）：Swing组件一览（5）

ゝ一纸荒年。 2022-11-24 14:15 162阅读 0赞

### 十三、菜单 ###

每个能够持有菜单的组件，包括JApplet、JFrame、JDialog以及它们的子类，它们都有一个setJMenuBar()方法，它接受一个JMenuBar对象（某个特定组件只能持有一个JMenuBar对象）作为参数。你先把JMenu对象添加到JMenuBar中，然后把JMenuItem添加到JMenu中。每个JMenuItem都能有一个相关联的ActionListener，用来捕获菜单项被选中时所触发的事件。

在Java的Swing中，必须在源代码中构造所有的菜单。下面是个非常简单的菜单例子：

package gui;
    
    import java.awt.FlowLayout;
    import java.awt.event.ActionEvent;
    import java.awt.event.ActionListener;
    
    import javax.swing.JFrame;
    import javax.swing.JMenu;
    import javax.swing.JMenuBar;
    import javax.swing.JMenuItem;
    import javax.swing.JTextField;
    
    import com.buba.util.SwingConsole;
    
    public class SimpleMenus extends JFrame {
    	private JTextField t = new JTextField(15);
    	private ActionListener al = new ActionListener() {
    		@Override
    		public void actionPerformed(ActionEvent e) {
    			t.setText(((JMenuItem) e.getSource()).getText());
    		}
    
    	};
    	private JMenu[] menus = { new JMenu("Winken"), new JMenu("Blinken"), new JMenu("Nod") };
    	private JMenuItem[] items = { new JMenuItem("Fee"), new JMenuItem("Fi"), new JMenuItem("Fo"), new JMenuItem("Zip"),
    			new JMenuItem("Zap"), new JMenuItem("Zot"), new JMenuItem("Olly"), new JMenuItem("Oxen"),
    			new JMenuItem("Free") };
    
    	public SimpleMenus() {
    		for (int i = 0; i < items.length; i++) {
    			items[i].addActionListener(al);
    			menus[i % 3].add(items[i]);
    		}
    		JMenuBar mb = new JMenuBar();
    		for (JMenu jm : menus)
    			mb.add(jm);
    		setJMenuBar(mb);
    		setLayout(new FlowLayout());
    		add(t);
    	}
    
    	public static void main(String[] args) {
    		SwingConsole.run(new SimpleMenus(), 200, 150);
    	}
    }

![20200806143228693.png][]

程序中通过取模运算“i%3”把菜单项分配给三个JMenu。每个JMenuItem必须有一个相关联的ActionListener：这里使用了同一个ActionListener，不过通常要为每个JMenuItem单独准备一个ActionListener。

JMenuItem从AbstractButton继承而来，所以它具有类似按钮的行为。它提供了一个可以单独放置在下拉菜单上的条目。还有三种类型继承自JMenuItem：JMenu用来持有其他的JMenuItem（这样才能实现层叠式菜单）；JCheckBoxMenuItem提供了一个复选标记，用来表明菜单项是否被选中；JRadioButtonMenuItem包含了一个单选按钮。

下面是一个更复杂的创建菜单的例子，这里仍然是冰激凌口味的例子。这个例子演示了层叠式菜单级、键盘快捷键、JCheckBoxMenuItem，以及动态改变菜单的方法：

package gui;
    
    import java.awt.BorderLayout;
    import java.awt.event.ActionEvent;
    import java.awt.event.ActionListener;
    import java.awt.event.ItemEvent;
    import java.awt.event.ItemListener;
    import java.awt.event.KeyEvent;
    
    import javax.swing.JButton;
    import javax.swing.JCheckBoxMenuItem;
    import javax.swing.JFrame;
    import javax.swing.JMenu;
    import javax.swing.JMenuBar;
    import javax.swing.JMenuItem;
    import javax.swing.JTextField;
    
    import com.buba.util.SwingConsole;
    
    public class Menus extends JFrame {
    	private String[] flavors = { "巧克力", "草莓", "香草软糖漩涡", "薄荷", "摩卡杏仁软糖", "朗姆酒葡萄干", "果仁糖奶油", "黑巧克力冰淇淋派" };
    	private JTextField t = new JTextField("No flavor", 30);
    	private JMenuBar mb1 = new JMenuBar();
    	private JMenu f = new JMenu("File"), m = new JMenu("Flavors"), s = new JMenu("Safety");
    	// 替代方法
    	private JCheckBoxMenuItem[] safety = { new JCheckBoxMenuItem("Guard"), new JCheckBoxMenuItem("Hide") };
    	private JMenuItem[] file = { new JMenuItem("Open") };
    	// 要切换到的第二个菜单栏
    	private JMenuBar mb2 = new JMenuBar();
    	private JMenu fooBar = new JMenu("fooBar");
    	private JMenuItem[] other = {
    			// 添加菜单快捷方式(助记符)非常简单，但是只有JMenuItems可以在其构造函数中包含它们
    			new JMenuItem("Foo", KeyEvent.VK_F), new JMenuItem("Bar", KeyEvent.VK_A),
    			// 没有快捷方式
    			new JMenuItem("Baz") };
    	private JButton b = new JButton("交换菜单");
    
    	class BL implements ActionListener {
    		@Override
    		public void actionPerformed(ActionEvent e) {
    			JMenuBar m = getJMenuBar();
    			setJMenuBar(m == mb1 ? mb2 : mb1);
    			validate();// refresh the frame
    		}
    	}
    
    	class ML implements ActionListener {
    		@Override
    		public void actionPerformed(ActionEvent e) {
    			JMenuItem target = (JMenuItem) e.getSource();
    			String actionCommand = target.getActionCommand();
    			if (actionCommand.equals("Open")) {
    				String s = t.getText();
    				boolean chosen = false;
    				for (String flavor : flavors)
    					if (s.equals(flavor))
    						chosen = true;
    				if (!chosen)
    					t.setText("Choose a flavor first!");
    				else
    					t.setText("Opening " + s + ". Mmm, mm!");
    			}
    		}
    	}
    
    	class FL implements ActionListener {
    		@Override
    		public void actionPerformed(ActionEvent e) {
    			JMenuItem target = (JMenuItem) e.getSource();
    			t.setText(target.getText());
    		}
    	}
    
    	// 或者，您可以为每个不同的MenuItem创建一个不同的类，这样您就不必弄清楚它是哪个
    	class FooL implements ActionListener {
    		@Override
    		public void actionPerformed(ActionEvent e) {
    			t.setText("Foo selected");
    		}
    	}
    
    	class BarL implements ActionListener {
    		@Override
    		public void actionPerformed(ActionEvent e) {
    			t.setText("Bar selected");
    		}
    	}
    
    	class BazL implements ActionListener {
    		@Override
    		public void actionPerformed(ActionEvent e) {
    			t.setText("Baz selected");
    		}
    	}
    
    	class CMIL implements ItemListener {
    		@Override
    		public void itemStateChanged(ItemEvent e) {
    			JCheckBoxMenuItem target = (JCheckBoxMenuItem) e.getSource();
    			String actionCommand = target.getActionCommand();
    			if (actionCommand.equals("Guard"))
    				t.setText("Guard the Ice Cream! Guarding is " + target.getState());
    			else if (actionCommand.equals("Hide"))
    				t.setText("Hide the Ice Cream! Is it hidden? " + target.getState());
    		}
    	}
    
    	public Menus() {
    		ML ml = new ML();
    		CMIL cmil = new CMIL();
    		safety[0].setActionCommand("Guard");
    		safety[0].setMnemonic(KeyEvent.VK_G);
    		safety[0].addItemListener(cmil);
    		safety[1].setActionCommand("Hide");
    		safety[1].setMnemonic(KeyEvent.VK_H);
    		safety[1].addItemListener(cmil);
    		other[0].addActionListener(new FooL());
    		other[1].addActionListener(new BarL());
    		other[2].addActionListener(new BazL());
    		FL fl = new FL();
    		int n = 0;
    		for (String flavor : flavors) {
    			JMenuItem mi = new JMenuItem(flavor);
    			mi.addActionListener(fl);
    			m.add(mi);
    			// 每隔一段时间添加分隔符
    			if ((n++ + 1) % 3 == 0)
    				m.addSeparator();
    		}
    		for (JCheckBoxMenuItem sfty : safety)
    			s.add(sfty);
    		s.setMnemonic(KeyEvent.VK_A);
    		f.add(s);
    		f.setMnemonic(KeyEvent.VK_F);
    		for (int i = 0; i < file.length; i++) {
    			file[i].addActionListener(ml);
    			f.add(file[i]);
    		}
    		mb1.add(f);
    		mb2.add(m);
    		setJMenuBar(mb1);
    		t.setEditable(false);
    		add(t, BorderLayout.CENTER);
    		// 设置切换菜单的系统
    		b.addActionListener(new BL());
    		b.setMnemonic(KeyEvent.VK_S);
    		add(b, BorderLayout.NORTH);
    		for (JMenuItem oth : other)
    			fooBar.add(oth);
    		fooBar.setMnemonic(KeyEvent.VK_B);
    		mb2.add(fooBar);
    	}
    
    	public static void main(String[] args) {
    		SwingConsole.run(new Menus(), 300, 200);
    	}
    }

![20200806153051104.png][]

在这个程序中，我把菜单项放到了几个数组中，然后通过遍历这些数组，并为每个JMenuItem调用add()方法，将它们添加到菜单中。这种方式让添加或减少菜单项不至于太乏味。

程序中不是创建了一个而是创建了两个JMenuBar，用以演示程序运行期间可以动态替换菜单条。你可以看到如何用JMenu构造JMenuBar，以及用JMenuItem、JCheckBoxMenuItem甚至其他JMenu（产生子菜单）来构成每个JMenu。当构造完一个JMenuBar后，可以使用setJMenuBar()方法把它安装到当前程序上。注意，当按钮按下的时候，它将通过调用getJMenuBar()来判断当前安装的是哪一个菜单条，然后换成另一个菜单条。

在测试Open菜单项的时候，要注意拼写和大小写是很关键的，如果没有任何匹配的Open，java也不会报告任何错误。这种类型的字符串比较是造成程序错误的根源之一。

菜单项的选中和清理能够被自动的处理。处理JCheckBoxMenuItem的代码演示了判断菜单项是否被选中的两种方式：字符串比较（缺乏安全的方式，尽管你会看到可以使用这种方法），和比较事件的目标对象。可以使用getState()方法得到是否选中的状态。还可以用setState()方法来改变JCheckBoxMenuItem的状态。

菜单对应的事件有些不一致，这可能会引起困惑：JMenuItem使用的是ActionListener，而JCheckBoxMenuItem使用的是ItemListener。JMenu对象虽然也支持ActionListener，不过其用处不大。一般来说，要把监听器关联到每一个JMenuItem、JCheckBoxMenuItem或者JRadioButtonMenuItem上，但是在上例中，ItemListener和ActionListener关联到了不同的菜单组件上。

Swing支持助记键，或者称为“键盘快捷键”，所以可以用键盘而不是鼠标来选择任何从AbstractButton（按钮，菜单项等等）继承而来的组件。做到这一点很简单；只要使用重载的构造器，使它的第二个参数接受快捷键的标识符即可。不过，大多数AbstractButton没有这样的构造器，所以更通用的做法是使用setMnemonic()方法。上例中为按钮和部分菜单项添加了快捷键；快捷指示符会自动出现在组件上。

你还能看到setActionCommand()的用法。它看起来有些奇怪，因为在每种情况下，“动作命令”与菜单上的标签都完全相同。为什么不直接使用标签而是这种额外的字符串呢？问题在于对国际化的支持。如果要把程序以另一种语言发布，最好是希望只改变菜单上的标签，而不用修改代码（毫无疑问，修改代码会引入新的错误）。通过使用setActionCommand()，可以把“动作命令”作为不变量，而把菜单上的标签作为可变量。所有的代码在运行时都使用“动作命令”，这样改变菜单标签的时候就不会影响代码。注意，在本例中，并非所有菜单都是基于“动作命令”进行判断的，这是因为没有专门为它们设定“动作命令”。

大量工作都是在监听器中完成的。BL执行的是JMenuBar的交换。在ML中，采用了“找出按铃者”方式，它的做法是先得到ActionEvent的事件源，然后把它类型转换成JMenuItem，接着得到其“动作命令”的字符串，并且把它传递给级联的if语句进行处理。

尽管FL监听器处理的是风味菜单中所有不同风味的菜单项，但它的确很简单。如果事件处理逻辑足够简单的话，这种方式值得参考。不过一般情况下会采用FooL、BarL和BazL里面所使用的方式，它们只被关联到一个菜单项，所以就不需要进行额外的判断，因为你明确知道是谁调用了监听器。尽管这种方式产生了更多的类，但是类内部的代码会更短，整个处理过程也更安全。

你会发现，有关菜单的代码很快就变得冗长而凌乱；这时，使用GUI构造工具才是明智的选择。好的工具还可以对菜单进行维护。

### 十四、弹出式菜单 ###

要实现一个JPopupMenu，最直接的方法就是创建一个继承自MouseAdapter的内部类，然后对每个希望具有弹出式行为的组件，都添加一个该内部类的对象：

package gui;
    
    import java.awt.FlowLayout;
    import java.awt.event.ActionEvent;
    import java.awt.event.ActionListener;
    import java.awt.event.MouseAdapter;
    import java.awt.event.MouseEvent;
    
    import javax.swing.JFrame;
    import javax.swing.JMenuItem;
    import javax.swing.JPopupMenu;
    import javax.swing.JTextField;
    
    import com.buba.util.SwingConsole;
    
    public class Popup extends JFrame {
    	private JPopupMenu popup = new JPopupMenu();
    	private JTextField t = new JTextField(10);
    
    	public Popup() {
    		setLayout(new FlowLayout());
    		add(t);
    		ActionListener al = new ActionListener() {
    			@Override
    			public void actionPerformed(ActionEvent e) {
    				t.setText(((JMenuItem) e.getSource()).getText());
    			}
    		};
    		JMenuItem m = new JMenuItem("Hither");
    		m.addActionListener(al);
    		popup.add(m);
    		m = new JMenuItem("Yon");
    		m.addActionListener(al);
    		popup.add(m);
    		m = new JMenuItem("Atar");
    		m.addActionListener(al);
    		popup.add(m);
    		popup.addSeparator();
    		m = new JMenuItem("Stay Here");
    		m.addActionListener(al);
    		popup.add(m);
    		PopupListener pl = new PopupListener();
    		addMouseListener(pl);
    		t.addMouseListener(pl);
    	}
    
    	class PopupListener extends MouseAdapter {
    		@Override
    		public void mousePressed(MouseEvent e) {
    			maybeShowPopup(e);
    		}
    
    		@Override
    		public void mouseReleased(MouseEvent e) {
    			maybeShowPopup(e);
    		}
    
    		private void maybeShowPopup(MouseEvent e) {
    			if (e.isPopupTrigger())
    				popup.show(e.getComponent(), e.getX(), e.getY());
    		}
    	}
    
    	public static void main(String[] args) {
    		SwingConsole.run(new Popup(), 300, 200);
    	}
    }

![20200806164141247.png][]

同一个ActionListener被添加到了每一个JMenuItem上，它要从菜单标签中抓取文本，然后插入到JTextField中。

**如果本文对您有很大的帮助，还请点赞关注一下。**

[20200806143228693.png]: /images/20221124/e8bd513d33864a1299e536a4e5437ebe.png
[20200806153051104.png]: /images/20221124/a3a6551eb0f9454393fb58dc0a267430.png
[20200806164141247.png]: /images/20221124/8a00e38e450d4e32801beed86351d20b.png