Java开发笔记(一百三十三)Swing的菜单
传统的桌面程序基本是对某种类型的文件进行加工,例如Window自带的记事本用来读写文本文件,自带的画图程序用来查看和修改位图文件。为了方便用户切换各种操作,这些程序在窗口顶端放了一排菜单栏,单击菜单栏上的每个菜单,又会在下方弹出一列菜单项,就像下图所示的记事本菜单那样。
然后单击某个菜单项,比如“新建”、“打开”、“保存”等,记事本程序便会执行相应的处理操作。
这组菜单在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()); } }); } } } }
接着运行编写好的菜单操作代码,弹出如下图所示的窗口界面。
在该窗口上单击“文件”菜单,在菜单下方弹出归属文件菜单的面板,详细界面如下图所示。
单击菜单面板上的“新建”菜单项,观察发现菜单面板消失不见,此时窗口主界面上的标签控件展示了单击事件的动作描述,下图便是此刻的窗口界面。
更多Java技术文章参见《Java开发笔记(序)章节目录》