Java开发笔记（一百三十三）Swing的菜单

墨蓝 2021-11-10 14:56 321阅读 0赞

传统的桌面程序基本是对某种类型的文件进行加工，例如Window自带的记事本用来读写文本文件，自带的画图程序用来查看和修改位图文件。为了方便用户切换各种操作，这些程序在窗口顶端放了一排菜单栏，单击菜单栏上的每个菜单，又会在下方弹出一列菜单项，就像下图所示的记事本菜单那样。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpbmxhbnR1_size_16_color_FFFFFF_t_70]  
然后单击某个菜单项，比如“新建”、“打开”、“保存”等，记事本程序便会执行相应的处理操作。  
这组菜单在Swing中被分解为三种控件，首先是顶部的一整条菜单栏，对应的控件叫JMenuBar；其次是菜单栏上的每个菜单，对应的控件叫JMenu；再次是菜单下拉面板中的每个菜单项，对应的控件叫JMenuItem。三种控件的层次关系为：菜单栏JMenuBar→菜单JMenu→菜单项JMenuItem，它们各司其职，才实现了多级菜单的分类功能。下面分别介绍这三种控件的用法。  
1、菜单栏JMenuBar  
菜单栏只是个框架，里面容纳了好几个菜单按钮，这些菜单排成一行才形成了菜单栏的模样。调用窗口对象Frame的setJMenuBar方法，即可将菜单栏添加至窗口顶部。至于JMenuBar的常用方法说明如下：  
add：在菜单栏上添加指定菜单。  
getMenuCount：获取菜单的数量。  
getMenu：获取指定位置的菜单。  
2、菜单JMenu  
菜单是菜单栏上的一个个文字按钮，调用菜单栏对象的add方法，即可将菜单添加至菜单栏。以下是JMenu的常用方法说明：  
setPreferredSize：设置菜单按钮的推荐宽高。  
setFont：设置菜单按钮的字体。  
add：在菜单上添加指定菜单项。  
addSeparator：在菜单上添加分隔线。  
getItemCount：获取菜单项的数量。  
getItem：获取指定位置的菜单项。  
3、菜单项JMenuItem  
单击菜单栏上的菜单按钮，会在下方弹出一块下拉面板，面板上罗列的正是归属该菜单的一列菜单项。调用菜单按钮的add方法，即可将菜单项添加至菜单。以下是JMenuItem的常用方法说明：  
setPreferredSize：设置菜单项的推荐宽高。  
setFont：设置菜单项的字体。  
setActionCommand：设置菜单项的动作命令。之后才能在单击事件的getActionCommand方法中获取单击来源动作命令。  
addActionListener：给菜单项注册单击监听器。

按照以上的菜单控件方法说明，接下来举个实际案例演示整个菜单的完整用法。首先设计一个菜单栏，其上包含“文件”、“编辑”、“帮助”三个菜单按钮，然后“文件”菜单下挂了“新建”、“打开”、“保存”、“退出”四个菜单项，“编辑”菜单下挂了“剪切”、“复制”、“粘贴”三个菜单项，“帮助”菜单下挂了“关于”一个菜单项。那么依次创建菜单栏、三个菜单，以及个菜单项下属的菜单项，再回头把菜单项添加至菜单，把菜单添加至菜单栏，把菜单栏添加至窗口，如此一番操作后的菜单组建代码示例如下：

JMenuBar menuBar = new JMenuBar(); // 创建一个菜单栏
    JMenu fileMenu = new JMenu("文件"); // 创建一个菜单
    JMenu editMenu = new JMenu("编辑"); // 创建一个菜单
    JMenu helpMenu = new JMenu("帮助"); // 创建一个菜单
    // 以下创建各个菜单项，并分配每个菜单项的动作命令
    JMenuItem newItem = new JMenuItem("新建"); // 创建一个菜单项
    newItem.setActionCommand("New"); // 设置菜单项的动作命令
    JMenuItem openItem = new JMenuItem("打开"); // 创建一个菜单项
    openItem.setActionCommand("Open"); // 设置菜单项的动作命令
    JMenuItem saveItem = new JMenuItem("保存"); // 创建一个菜单项
    saveItem.setActionCommand("Save"); // 设置菜单项的动作命令
    JMenuItem exitItem = new JMenuItem("退出"); // 创建一个菜单项
    exitItem.setActionCommand("Exit"); // 设置菜单项的动作命令
    JMenuItem cutItem = new JMenuItem("剪切"); // 创建一个菜单项
    cutItem.setActionCommand("Cut"); // 设置菜单项的动作命令
    JMenuItem copyItem = new JMenuItem("复制"); // 创建一个菜单项
    copyItem.setActionCommand("Copy"); // 设置菜单项的动作命令
    JMenuItem pasteItem = new JMenuItem("粘贴"); // 创建一个菜单项
    pasteItem.setActionCommand("Paste"); // 设置菜单项的动作命令
    JMenuItem aboutItem = new JMenuItem("关于"); // 创建一个菜单项
    aboutItem.setActionCommand("About"); // 设置菜单项的动作命令
    // 以下把每个菜单项添加到对应的菜单上
    fileMenu.add(newItem); // 在菜单上添加菜单项
    fileMenu.add(openItem); // 在菜单上添加菜单项
    fileMenu.add(saveItem); // 在菜单上添加菜单项
    fileMenu.addSeparator(); // 在菜单上添加分隔线
    fileMenu.add(exitItem); // 在菜单上添加菜单项
    editMenu.add(copyItem); // 在菜单上添加菜单项
    editMenu.add(pasteItem); // 在菜单上添加菜单项
    helpMenu.add(aboutItem); // 在菜单上添加菜单项
    // 以下把每个菜单都添加到菜单栏上
    menuBar.add(fileMenu); // 在菜单栏上添加菜单
    menuBar.add(editMenu); // 在菜单栏上添加菜单
    menuBar.add(helpMenu); // 在菜单栏上添加菜单
    frame.setJMenuBar(menuBar); // 在窗口上添加菜单栏
    setMenuAction(menuBar, font); // // 设置菜单项的外观及其动作事件

可是上面的代码仅仅完成菜单层级的构建，既没有定制菜单的外观，也无法响应菜单项的单击事件。为此还得编写单独的setMenuAction方法，在该方法中逐个设置每个菜单按钮、菜单项的尺寸与字体，同时给每个菜单项注册单击事件，这样在用户选择某个菜单项之后，程序才能获知是哪个菜单项被选中了。setMenuAction方法的定义代码如下所示：

// 设置菜单项的外观及其动作事件
    private static void setMenuAction(JMenuBar bar, Font font) {
    	for (int i = 0; i < bar.getMenuCount(); i++) { // 遍历菜单栏下的所有菜单
    		JMenu menu = bar.getMenu(i); // 获取指定位置的菜单
    		menu.setFont(font); // 设置菜单按钮的文本字体
    		menu.setPreferredSize(new Dimension(60, 30)); // 设置菜单按钮的推荐宽高
    		for (int j = 0; j < menu.getItemCount(); j++) { // 遍历菜单下的所有菜单项
    			JMenuItem item = menu.getItem(j); // 获取指定位置的菜单项
    			if (item != null) { // 菜单项非空。这个判断是为了避开菜单项之间的分隔线
    				item.setFont(font); // 设置菜单项的文本字体
    				item.setPreferredSize(new Dimension(120, 28)); // 设置菜单项的推荐宽高
    				item.addActionListener(new ActionListener() { // 给菜单项注册单击监听器
    					public void actionPerformed(ActionEvent e) { // 发生了单击事件
    						// 调用getActionCommand方法获取单击事件的动作命令，并展示在标签上
    						label.setText("您点击了菜单项：" + e.getActionCommand());
    					}
    				});
    			}
    		}
    	}
    }

接着运行编写好的菜单操作代码，弹出如下图所示的窗口界面。  
![在这里插入图片描述][20190803125256585.png]  
在该窗口上单击“文件”菜单，在菜单下方弹出归属文件菜单的面板，详细界面如下图所示。  
![在这里插入图片描述][20190803125313412.png]  
单击菜单面板上的“新建”菜单项，观察发现菜单面板消失不见，此时窗口主界面上的标签控件展示了单击事件的动作描述，下图便是此刻的窗口界面。  
![在这里插入图片描述][20190803125325327.png]

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

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpbmxhbnR1_size_16_color_FFFFFF_t_70]: /images/20211109/05fe08ece7704480b17560c6646d4a0c.png
[20190803125256585.png]: /images/20211109/63e755267c124b15ad5b4575c7a69202.png
[20190803125313412.png]: /images/20211109/7c0eeb22fdd74dd3b57fb37f7d870edc.png
[20190803125325327.png]: /images/20211109/8d09cba623d243dc9d2184dffeda3b14.png
[Java]: https://blog.csdn.net/pinlantu/article/details/83957672