Java Swing JMenu和JPopupMenu：菜单和弹出式菜单

Dear 丶 2024-03-30 11:33 132阅读 0赞

菜单由 Swing 中的 JMenu 类实现，可以包含多个菜单项和带分隔符的菜单。在菜单中，菜单项由 JMenuItem 类表示，分隔符由 JSeparator 类表示。

菜单本质上是带有关联 JPopupMenu 的按钮。当按下“按钮”时，就会显示 JPopupMenu。如果“按钮”位于 JMenuBar 上，则该菜单为顶层窗口。如果“按钮”是另一个菜单项，则 JPopupMenu 就是“下拉”菜单。

### JMenu 类的常用方法 ###

创建菜单常用构造方法有两个：JMenu() 和 JMenu(String s)。第一个构造方法创建一个无文本的 JMenu 对象，第二个构造方法创建一个带有指定文本的 JMenu 对象。JMenu 类的常用方法如表 1 所示。

<table> 
 <thead> 
  <tr> 
   <th>方法名称</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>add(Action a)</td> 
   <td>创建连接到指定 Action 对象的新菜单项，并将其追加到此菜单的末尾</td> 
  </tr> 
  <tr> 
   <td>add(Component c)</td> 
   <td>将某个组件追加到此菜单的末尾</td> 
  </tr> 
  <tr> 
   <td>add(Component c,int index)</td> 
   <td>将指定组件添加到此容器的给定位置</td> 
  </tr> 
  <tr> 
   <td>add(JMenuItem menultem)</td> 
   <td>将某个菜单项追加到此菜单的末尾</td> 
  </tr> 
  <tr> 
   <td>add(String s)</td> 
   <td>创建具有指定文本的新菜单项，并将其追加到此菜单的末尾</td> 
  </tr> 
  <tr> 
   <td>addSeparator()</td> 
   <td>将新分隔符追加到菜单的末尾</td> 
  </tr> 
  <tr> 
   <td>doCliclc(int pressTime)</td> 
   <td>以编程方式执行“单击”操作</td> 
  </tr> 
  <tr> 
   <td>getDelay()</td> 
   <td>返回子菜单向上或向下弹出前建议的延迟（以毫秒为单位）</td> 
  </tr> 
  <tr> 
   <td>getltem(int pos)</td> 
   <td>返回指定位置的 JMenuItem</td> 
  </tr> 
  <tr> 
   <td>getItemCount()</td> 
   <td>返回菜单上的项数，包括分隔符</td> 
  </tr> 
  <tr> 
   <td>getMenuComponent(int n)</td> 
   <td>返回位于位置 n 的组件</td> 
  </tr> 
  <tr> 
   <td>getMenuComponents()</td> 
   <td>返回菜单子组件的 Component 数组</td> 
  </tr> 
  <tr> 
   <td>getSubElements()</td> 
   <td>返回由 MenuElement 组成的数组，其中包含此菜单组件的子菜单</td> 
  </tr> 
  <tr> 
   <td>insert(JMenuItem mi,int pos)</td> 
   <td>在给定位置插入指定的 JMenuitem</td> 
  </tr> 
  <tr> 
   <td>insert(String s,pos)</td> 
   <td>在给定位置插入具有指定文本的新菜单项</td> 
  </tr> 
  <tr> 
   <td>insertSeparator(int index)</td> 
   <td>在指定的位置插入分隔符</td> 
  </tr> 
  <tr> 
   <td>isMenuComponent(Component c)</td> 
   <td>如果在子菜单层次结构中存在指定的组件，则返回 true</td> 
  </tr> 
  <tr> 
   <td>isPopupMenuVisible()</td> 
   <td>如果菜单的弹出窗口可见，则返回 rue</td> 
  </tr> 
  <tr> 
   <td>isSelected()</td> 
   <td>如果菜单是当前选择的（即高亮显示的）菜单，则返回 true</td> 
  </tr> 
  <tr> 
   <td>isTopLevelMenu()</td> 
   <td>如果菜单是“顶层菜单”（即菜单栏的直接子级），则返回 true</td> 
  </tr> 
  <tr> 
   <td>setDelay(int d)</td> 
   <td>设置菜单的 PopupMenu 向上或向下弹出前建议的延迟</td> 
  </tr> 
  <tr> 
   <td>setMenuLocation(int x,int y)</td> 
   <td>设置弹出组件的位置</td> 
  </tr> 
  <tr> 
   <td>setPopupMenuVisible(boolean b)</td> 
   <td>设置菜单弹出的可见性</td> 
  </tr> 
  <tr> 
   <td>setSelected(boolean b)</td> 
   <td>设置菜单的选择状态</td> 
  </tr> 
 </tbody> 
</table>

例 1

菜单如果依附到 JMenuBar 对象上，则此菜单就是菜单栏中的菜单。菜单如果依附在 JPopupMenu 对象上，此菜单就是弹出式菜单。实现菜单栏和弹出式菜单的原理是一样的，但在具体的实现方式上有一些区别。

下面编写一个案例，使用 JMenuBar 类创建一个包含“文件”菜单和“编辑”菜单的菜单窗口。主要实现代码如下：

> 1.  `package ch18;`
> 2.  `import java.awt.event.ActionEvent;`
> 3.  `import java.awt.event.KeyEvent;`
> 4.  `import javax.swing.JCheckBoxMenuItem;`
> 5.  `import javax.swing.JFrame;`
> 6.  `import javax.swing.JMenu;`
> 7.  `import javax.swing.JMenuBar;`
> 8.  `import javax.swing.JMenuItem;`
> 9.  `import javax.swing.KeyStroke;`
> 10. `public class JMenuDemo1 extends JMenuBar`
> 11. `{`
> 12. `public JMenuDemo1()`
> 13. `{`
> 14. `add(createFileMenu()); //添加“文件”菜单`
> 15. `add(createEditMenu()); //添加“编辑”菜单`
> 16. `setVisible(true);`
> 17. `}`
> 18. `public static void main(String[] agrs)`
> 19. `{`
> 20. `JFrame frame=new JFrame("菜单栏");`
> 21. `frame.setSize(300,200);`
> 22. `frame.setJMenuBar(new JMenuDemo1());`
> 23. `frame.setVisible(true);`
> 24. `}`
> 25. `//定义“文件”菜单`
> 26. `private JMenu createFileMenu()`
> 27. `{`
> 28. `JMenu menu=new JMenu("文件(F)");`
> 29. `menu.setMnemonic(KeyEvent.VK_F); //设置快速访问符`
> 30. `JMenuItem item=new JMenuItem("新建(N)",KeyEvent.VK_N);`
> 31. `item.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_N,ActionEvent.CTRL_MASK));`
> 32. `menu.add(item);`
> 33. `item=new JMenuItem("打开(O)",KeyEvent.VK_O);`
> 34. `item.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_O,ActionEvent.CTRL_MASK));`
> 35. `menu.add(item);`
> 36. `item=new JMenuItem("保存(S)",KeyEvent.VK_S);`
> 37. `item.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_S,ActionEvent.CTRL_MASK));`
> 38. `menu.add(item);`
> 39. `menu.addSeparator();`
> 40. `item=new JMenuItem("退出(E)",KeyEvent.VK_E);`
> 41. `item.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_E,ActionEvent.CTRL_MASK));`
> 42. `menu.add(item);`
> 43. `return menu;`
> 44. `}`
> 45. `//定义“编辑”菜单`
> 46. `private JMenu createEditMenu()`
> 47. `{`
> 48. `JMenu menu=new JMenu("编辑(E)");`
> 49. `menu.setMnemonic(KeyEvent.VK_E);`
> 50. `JMenuItem item=new JMenuItem("撤销(U)",KeyEvent.VK_U);`
> 51. `item.setEnabled(false);`
> 52. `menu.add(item);`
> 53. `menu.addSeparator();`
> 54. `item=new JMenuItem("剪贴(T)",KeyEvent.VK_T);`
> 55. `menu.add(item);`
> 56. `item=new JMenuItem("复制(C)",KeyEvent.VK_C);`
> 57. `menu.add(item);`
> 58. `menu.addSeparator();`
> 59. `JCheckBoxMenuItem cbMenuItem=new JCheckBoxMenuItem("自动换行");`
> 60. `menu.add(cbMenuItem);`
> 61. `return menu;`
> 62. `}`
> 63. `}`

上述代码调用 JMenu 对象的 setMnemonic() 方法设置当前菜单的快速访问符。该符号必须对应键盘上的一个键，并且应该使用 java.awt.event.KeyEvent 中定义的 VK—XXX 键代码之一指定。

提示：快速访问符是一种快捷键，通常在按下 Alt 键和某个字母时激活。例如，常用的 Alt+F 是“文件” 菜单的快速访问符。

JMenuItem 类实现的是菜单中的菜单项。菜单项本质上是位于列表中的按钮。当用户单击“按钮”时，则执行与菜单项关联的操作。JMenuItem 的常用构造方法有以下三个。

> 1.  JMenuItem(String text)：创建带有指定文本的 JMenuItem。
> 2.  JMenuItem(String text,Icon icon)：创建带有指定文本和图标的 JMenuItem。
> 3.  JMenuItem(String text,int mnemonic)：创建带有指定文本和键盘助记符的 JMenuItem。

在该实例中，创建菜单项后调用 JMenuItem 对象的 setAccelerator(KeyStroke) 方法来设置修改键，它能直接调用菜单项的操作监听器而不必显示菜单的层次结构。在本实例中没有实现事件监听机制，所以使用快捷键时将得不到程序的任何响应，但是在菜单项中将出现快捷键。

运行该实例，图 1 所示是“文件”菜单展开效果，图 2 所示是“编辑”菜单展开的效果。

![29bc1aefd07e4bb70ae83ce8acbda9a6.gif][]

图1 “文件”菜单

![4a8de0a827354e19963e9ee0f0652318.gif][]

图2 “编辑”菜单

### 弹出式菜单 JPopuMenu ###

弹出式菜单由 JPopupMenu 类实现，它是一个可弹出并显示一系列选项的小窗口。它还用于当用户选择菜单项并激活它时显示的“右拉式(pull-right)”菜单，可以在想让菜单显示的任何其他位置使用。例如，当用户在指定区域中右击时。

JPopupMenu 类的常用方法如表 2 所示。

<table> 
 <thead> 
  <tr> 
   <th>方法名称</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>getInvoker()</td> 
   <td>返回作为此弹出菜单的“调用者”的组件</td> 
  </tr> 
  <tr> 
   <td>setInvoker(Component invoker)</td> 
   <td>设置弹出菜单的调用者，即弹出菜单在其中显示的组件</td> 
  </tr> 
  <tr> 
   <td>addPopupMenuListener(PopupMenuListener1)</td> 
   <td>添加 PopupMenu 监听器</td> 
  </tr> 
  <tr> 
   <td>removePopupMenuListener(PopupMenuListener1)</td> 
   <td>移除 PopupMenu 监听器</td> 
  </tr> 
  <tr> 
   <td>getPopupMenuListeners()</td> 
   <td>返回利用 addPopupMenuListener()添加到此 JMenuitem 的所有 PopupMenuListener 组成的数组</td> 
  </tr> 
  <tr> 
   <td>getLabel()</td> 
   <td>返回弹出菜单的标签</td> 
  </tr> 
  <tr> 
   <td>setLabel(String label)</td> 
   <td>设置弹出菜单的标签</td> 
  </tr> 
  <tr> 
   <td>show(Component invoker,int x,int y)</td> 
   <td>在调用者的坐标空间中的位置 X、Y 处显示弹出菜单</td> 
  </tr> 
  <tr> 
   <td>getComponentIndex(Component c)</td> 
   <td>返回指定组件的索引</td> 
  </tr> 
 </tbody> 
</table>

例 2

使用 JPopupMenu 类创建一个弹出式菜单，并在菜单中使用子菜单。主要实现代码如下：

> 1.  `package ch18;`
> 2.  `import java.awt.event.MouseAdapter;`
> 3.  `import java.awt.event.MouseEvent;`
> 4.  `import java.awt.event.MouseListener;`
> 5.  `import javax.swing.ButtonGroup;`
> 6.  `import javax.swing.JFrame;`
> 7.  `import javax.swing.JMenu;`
> 8.  `import javax.swing.JMenuItem;`
> 9.  `import javax.swing.JPopupMenu;`
> 10. `import javax.swing.JRadioButtonMenuItem;`
> 11. `public class JPopupMenuDemo extends JFrame`
> 12. `{`
> 13. `JMenu fileMenu;`
> 14. `JPopupMenu jPopupMenuOne;`
> 15. `JMenuItem openFile,closeFile,exit;`
> 16. `JRadioButtonMenuItem copyFile,pasteFile;`
> 17. `ButtonGroup buttonGroupOne;`
> 18. `public JPopupMenuDemo()`
> 19. `{`
> 20. `jPopupMenuOne=new JPopupMenu(); //创建jPopupMenuOne对象`
> 21. `buttonGroupOne=new ButtonGroup();`
> 22. `//创建文件菜单及子菜单，并将子菜单添加到文件菜单中`
> 23. `fileMenu=new JMenu("文件");`
> 24. `openFile=new JMenuItem("打开");`
> 25. `closeFile=new JMenuItem("关闭");`
> 26. `fileMenu.add(openFile);`
> 27. `fileMenu.add(closeFile);`
> 28. `//将fileMenu菜单添加到弹出式菜单中`
> 29. `jPopupMenuOne.add(fileMenu);`
> 30. `//添加分割符`
> 31. `jPopupMenuOne.addSeparator();`
> 32. `//创建单选菜单项，并添加到ButtonGroup对象中`
> 33. `copyFile=new JRadioButtonMenuItem("复制");`
> 34. `pasteFile=new JRadioButtonMenuItem("粘贴");`
> 35. `buttonGroupOne.add(copyFile);`
> 36. `buttonGroupOne.add(pasteFile);`
> 37. `//将copyFile添加到jPopupMenuOne中`
> 38. `jPopupMenuOne.add(copyFile);`
> 39. `//将pasteFile添加到jPopupMenuOne中`
> 40. `jPopupMenuOne.add(pasteFile);`
> 41. `jPopupMenuOne.addSeparator();`
> 42. `exit=new JMenuItem("退出");`
> 43. `//将exit添加到jPopupMenuOne中`
> 44. `jPopupMenuOne.add(exit);`
> 45. `//创建监听器对象`
> 46. `MouseListener popupListener=new PopupListener(jPopupMenuOne);`
> 47. `//向主窗口注册监听器`
> 48. `this.addMouseListener(popupListener);`
> 49. `this.setTitle("弹出式菜单");`
> 50. `this.setBounds(100,100,250,150);`
> 51. `this.setVisible(true);`
> 52. `this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);`
> 53. `}`
> 54. `public static void main(String args[])`
> 55. `{`
> 56. `new JPopupMenuDemo();`
> 57. `}`
> 58. `//添加内部类，其扩展了MouseAdapter类，用来处理鼠标事件`
> 59. `class PopupListener extends MouseAdapter`
> 60. `{`
> 61. `JPopupMenu popupMenu;`
> 62. `PopupListener(JPopupMenu popupMenu)`
> 63. `{`
> 64. `this.popupMenu=popupMenu;`
> 65. `}`
> 66. `public void mousePressed(MouseEvent e)`
> 67. `{`
> 68. `showPopupMenu(e);`
> 69. `}`
> 70. `public void mouseReleased(MouseEvent e)`
> 71. `{`
> 72. `showPopupMenu(e);`
> 73. `}`
> 74. `private void showPopupMenu(MouseEvent e)`
> 75. `{`
> 76. `if(e.isPopupTrigger())`
> 77. `{`
> 78. `//如果当前事件与鼠标事件相关，则弹出菜单`
> 79. `popupMenu.show(e.getComponent(),e.getX(),e.getY());`
> 80. `}`
> 81. `}`
> 82. `}`
> 83. `}`

在使用弹出菜单时一定要注意层次关系和菜单的位置。程序运行后由于菜单没有被激活所以窗口是空白的，如图 1 所示。单击鼠标右键即可查看弹出式菜单，如图 2 所示。

![9867d074b5cba7809ada498f89644a70.gif][]

![37dd12cea7e569ec02f1a35cebe5b9fa.gif][]

图2 弹出式菜单

[29bc1aefd07e4bb70ae83ce8acbda9a6.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/e715a6fd7389453ba7dcafb25e76a8b3.gif
[4a8de0a827354e19963e9ee0f0652318.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/fe0217f59378492192e5dab55f41fd15.gif
[9867d074b5cba7809ada498f89644a70.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/c8aca99b7cf143eba0f6183070c4bc7e.gif
[37dd12cea7e569ec02f1a35cebe5b9fa.gif]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ffef4970cf1e4c1b81ec32537a0c9e29.gif