JPopupMenu

12-7：使用 JPopupMenu 组件。

　　JPopupMenu 的类层次结构图：

　　java.lang.Object
　　　--java.awt.Component
　　　　--java.awt.Container
　　　　　--javax.swing.JComponent
　　　　　　--javax.swing.JPopupMenu

　 　JPopupMenu 是一种特别形式的 Menu，其性质与 Menu 几乎完全相同，但是 PopupMenu 并不固定在窗口的任何一个位置，而是由鼠标指针和系统判断决定 PopupMenu 要出现在哪里。相信大家在使用许多软件时都有用过 Popupmenu 的功能，例如在使用 Word 文书编辑器软件时，当我们在编辑区域的任一处按下鼠标右键，就会跳出一个 PopupMenu 菜单。

　　JPopupMenu 构造函数：
　　JPopupMenu()：建立一个新的 JPopupMenu;
　　JPopupMenu(String label)：建立一个指定标题的 JPopupMenu。

　　12-7-1：构造 JPopupMenu 组件：

　　我们知道 JPopupMenu 的构造方法并不复杂，两种构造方法的差异只在于是否赋予 JPopupMenu 一个标题文字。我们马上来看下面这个范例，了解如何应用 JPopupMenu。

　　import javax.swing.*;
　　import java.awt.*;
　　import java.awt.event.*;
　　import javax.swing.event.*;
　　import javax.swing.border.*;
　　import java.util.*;
　　import com.incors.plaf.alloy.*;
　　import com.incors.plaf.alloy.themes.glass.*;

　　public class JPopupMenu1 extends JFrame{

　　　　JTextArea theArea = null;
　　　　static final String ComboStr[] = {"Times New Roman","Dialog","宋体","黑体","楷体"};
　　　　JPopupMenu Popup = null;//声明一个全局 (Global) 并设置初始值为 null 的 JPopupMenu 组件。

　　　　public JPopupMenu1(){
　　　
　　　　　　super("JPopupMenu1");
　　　　　　theArea = new JTextArea();
　　　　　　theArea.setEditable(false);
　　　　　　this.getContentPane().add(new JScrollPane(theArea),BorderLayout.CENTER);
　　　　　　JMenuBar MBar = new JMenuBar();
　　　　　　MBar.setOpaque(true);
　　　　　　JMenu mfile = buildFileMenu();
　　　　　　JToolBar theBar = buildToolBar();
　　　　　　this.getContentPane().add(theBar,BorderLayout.NORTH);
　　　　　　PopupPanel pp = new PopupPanel();//new 一个 PopupPanel 组件来放置 JPopupMenu。
　　　　　　this.getContentPane().add(pp,BorderLayout.SOUTH); //将 PopupPanel 组件放置到窗口中。

　　　　　　MBar.add(mfile);
　　　　　　setJMenuBar(MBar);
　　　　}//end of JPopupMenu1()

　　　　/*****************begin**********************
　　　　分别建立程序中菜单，工具栏和事件处理模式的部份，我们在此不再加以说明。
　　　　****************************************/

　　　　public JMenu buildFileMenu() {

　　　　　　JMenu thefile = new JMenu("File");
　　　　　　thefile.setMnemonic('F');

　　　　　　JMenuItem newf = new JMenuItem("New",new ImageIcon("icons/new24.gif"));
　　　　　　JMenuItem open = new JMenuItem("Open",new ImageIcon("icons/open24.gif"));
　　　　　　JMenuItem close= new JMenuItem("Close",new ImageIcon("icons/close24.gif"));
　　　　　　JMenuItem quit = new JMenuItem("Exit",new ImageIcon("icons/exit24.gif"));

　　　　　　newf.setMnemonic('N');
　　　　　　open.setMnemonic('O');
　　　　　　close.setMnemonic('L');
　　　　　　quit.setMnemonic('X');

　　　　　　newf.setAccelerator( KeyStroke.getKeyStroke('N', java.awt.Event.CTRL_MASK, false) );
　　　　　　open.setAccelerator( KeyStroke.getKeyStroke('O', java.awt.Event.CTRL_MASK, false) );
　　　　　　close.setAccelerator( KeyStroke.getKeyStroke('L', java.awt.Event.CTRL_MASK, false) );
　　　　　　quit.setAccelerator( KeyStroke.getKeyStroke('X', java.awt.Event.CTRL_MASK, false) );

　　　　　　newf.addActionListener(new ActionListener() {
　　　　　　　　public void actionPerformed(ActionEvent e) {
　　　　　　　　　　theArea.append("- MenuItem New Performed -\n");
　　　　　　}});

　　　　　　open.addActionListener(new ActionListener() {
　　　　　　　　public void actionPerformed(ActionEvent e) {
　　　　　　　　　　theArea.append("- MenuItem Open Performed -\n");
　　　　　　}});

　　　　　　close.addActionListener(new ActionListener() {
　　　　　　　　public void actionPerformed(ActionEvent e) {
　　　　　　　　　　theArea.append("- MenuItem Close Performed -\n");
　　　　　　}});

　　　　　　quit.addActionListener(new ActionListener() {
　　　　　　　　public void actionPerformed(ActionEvent e) {
　　　　　　　　　　System.exit(0);
　　　　　　}});

　　　　　　thefile.add(newf);
　　　　　　thefile.add(open);
　　　　　　thefile.add(close);
　　　　　　thefile.addSeparator();
　　　　　　thefile.add(quit);

　　　　　　return thefile;
　　　　}//end of buildFileMenu()
　
　　　　public JToolBar buildToolBar() {
　　
　　　　　　JToolBar toolBar = new JToolBar();
　　　　　　toolBar.setFloatable(true);

　　　　　　ToolBarAction tba_new = new ToolBarAction("new",new ImageIcon("icons/new24.gif"));
　　　　　　ToolBarAction tba_open = new ToolBarAction("open",new ImageIcon("icons/open24.gif"));
　　　　　　ToolBarAction tba_close = new ToolBarAction("close",new ImageIcon("icons/close24.gif"));

　　　　　　JButton JB;
　　　　　　JB = toolBar.add(tba_new);
　　　　　　JB.setActionCommand("#TooBar_NEW performed!");
　　　　　　JB.setToolTipText((String)tba_new.getValue(Action.NAME));
　　　　　　JB = toolBar.add(tba_open);
　　　　　　JB.setActionCommand("#ToolBar_OPEN performed!");
　　　　　　JB.setToolTipText((String)tba_open.getValue(Action.NAME));
　　　　　　JB = toolBar.add(tba_close);
　　　　　　JB.setActionCommand("#ToolBar_CLOSE performed!");
　　　　　　JB.setToolTipText((String)tba_close.getValue(Action.NAME));
　　
　　　　　　toolBar.addSeparator();
　
　　　　　　ToolBarAction tba_B = new ToolBarAction("bold",new ImageIcon("icons/bold24.gif"));
　　　　　　ToolBarAction tba_I = new ToolBarAction("italic",new ImageIcon("icons/italic24.gif"));
　　　　　　ToolBarAction tba_U = new ToolBarAction("underline",new ImageIcon("icons/underline24.gif"));
　　　　　　JB = toolBar.add(tba_B);
　　　　　　JB.setActionCommand("#ToolBar_Bold performed!");
　　　　　　JB.setToolTipText((String)tba_B.getValue(Action.NAME));
　　　　　　JB = toolBar.add(tba_I);
　　　　　　JB.setActionCommand("#ToolBar_Italic performed!");
　　　　　　JB.setToolTipText((String)tba_I.getValue(Action.NAME));
　　　　　　JB = toolBar.add(tba_U);
　　　　　　JB.setActionCommand("#ToolBar_Underline performed!");
　　　　　　JB.setToolTipText((String)tba_U.getValue(Action.NAME));
　
　　　　　　toolBar.addSeparator();
　　　　　　JLabel JLfont = new JLabel("Font Type");
　　　　　　toolBar.add(JLfont);
　　　　　　toolBar.addSeparator();
　　　　　　JComboBox jcb = new JComboBox(ComboStr);
　　　　　　jcb.addActionListener(new ActionListener() {
　　　　　　　　public void actionPerformed(ActionEvent e) {
　　　　　　　　theArea.append("*Combobox "+((JComboBox)e.getSource()).getSelectedItem()+"performed!\n");
　　　　　　}});
　　　　　　toolBar.add(jcb);
　　
　　　　　　return toolBar;
　　　　}//end of buildToolBar()
　　　　/*****************End**********************
　　　　分别建立程序中菜单，工具栏和事件处理模式的部份，我们在此不再加以说明。
　　　　****************************************/
　　
　　　　public static void main(String[] args){
　　　　　　SwingUtil.setLookAndFeel();
　　　　　　JFrame F = new JPopupMenu1();
　　　　　　F.setSize(430,200);
　　　　　　F.addWindowListener(new WindowAdapter() {
　　　　　　　　public void windowClosing(WindowEvent e) {
　　　　　　　　　　System.exit(0);
　　　　　　　　}
　　　　　　});//end of addWindowListener
　　　　　　F.setVisible(true);
　　　　} // end of main

　　class ToolBarAction extends AbstractAction{

　　　　public ToolBarAction(String name,Icon icon){
　　　　　　super(name,icon);
　　　　}

　　　　public void actionPerformed(ActionEvent e){
　
　　　　　　try{
　　　　　　　　theArea.append(e.getActionCommand()+"\n");
　　　　　　}catch(Exception ex){}
　　　　}
　　}//end of inner class ToolBarAction

　　本方法建立inner class PopupPanel。这个类继承 JPanel 并实作 MouseListener，PopupMenuListener，ActionListener 和 ActionListener等 3 个 Listener。MouseListener为处理鼠标事件的 Listener，PopupMenuListener 为 Popup 菜单事件的 Listener，ActionListener 则是大家最熟悉用来处理 JMenuItem 事件的 Listener。

　　class PopupPanel extends JPanel implements MouseListener,PopupMenuListener,ActionListener{

　　　　public PopupPanel(){
　
　　　　Popup = new JPopupMenu();//new 一个新的JPopupMenu。
　
　　　　JMenuItem theItem;
　
　　　　//分别建立四个 JMenuItem 和其事件处理模式将将 JMenuItem 加入 JPopupMenu 中。

　　　　Popup.add(theItem = new JMenuItem("Cut",new ImageIcon("icons/cut24.gif")));//建立JMenuItem 组件。
　　　　theItem.addActionListener(this);//将 JMenuItem 组件加入事件处理模式。
　　　　Popup.add(theItem = new JMenuItem("Copy",new ImageIcon("icons/copy24.gif")));
　　　　theItem.addActionListener(this);
　　　　Popup.add(theItem = new JMenuItem("Paste",new ImageIcon("icons/paste24.gif")));
　　　　theItem.addActionListener(this);
　　　　Popup.addSeparator();//在 JPopupMenu 中加入分隔线，我们在前面有提到 JPopupMenu 和 Menu 大致上的性质是一样的，所以在 JPopupMenu 中一样是以 JMenuItem 来当作选项的组件。

　　　　Popup.add(theItem = new JMenuItem("Page Setup..."));
　　　　theItem.addActionListener(this);
　
　　　　//利用 setBorder() 方法将 BevelBorde r类当作参数传入，使 JPopupMenu 产生立体边框浮起的效果。我们也可以将参数设置改为 BevelBorder.LOWERED 使得 JPopupMenu 产生立体边框凹陷的效果。

　　　　Popup.setBorder(new BevelBorder(BevelBorder.RAISED));

　　　　Popup.addPopupMenuListener(this); //将 JPopupMenu 组件加入 PopupMenu 事件处理模式中。
　　　　addMouseListener(this);//将PopupPanel类加入 Mouse 事件处理模式中。
　　　　theArea.addMouseListener(this);//后面有说明
　　
　　}//end of PopupPanel()

　　由于 PopupPanel 这个 inner class 中实作了 MouseListener，因此需要覆写 mouseClicked()，mousePressed()，*mouseReleased()，mouseEntered() 和 mouseExited() 等 5 个方法。在这个范例里当 mouseClicked()，mousePressed() 和 mouseReleased() 等 3 个方法被触发时会调用 checkPopup() 方法来判断是否要将 PopupMenu 输出来。

　　　　public void mouseClicked(MouseEvent me){ checkPopup(me);}
　　　　public void mousePressed(MouseEvent me){ checkPopup(me);}
　　　　public void mouseReleased(MouseEvent me){ checkPopup(me);}
　　　　public void mouseEntered(MouseEvent me){}
　　　　public void mouseExited(MouseEvent me){}

　　　　checkPopup() 方法。其中，在程序中利用 isPopupTrigger() 方法判断 PopupMenu 是否已经输出。若没有，则在程序中利用 show() 方法将 PopupMenu 输出目前鼠标指针(利用 getX() 和 getY() 方法得知)的位置上。

　　　　private void checkPopup(MouseEvent me){
　　　　　　if(me.isPopupTrigger()){
　　　　　　　　Popup.show(me.getComponent(), me.getX(), me.getY());
　　　　　　}
　　　　}//end of checkPopup()
　　　
　　　　由于 PopupPanel 这个 inner class 实作了 PopupMenuListener，因此需要覆写popupMenuWillBecomeVisible()， popupMenuWillBecomeInvisible() 方法和 popupMenuCanceled() 等 3 个方法。在这个范例里当这 3 个方法被触发后会在JTextArea中加入一个信息。

　　　　public void popupMenuWillBecomeVisible(PopupMenuEvent pme){
　　　　　　theArea.append("-PopupMenu Visibel!\n");
　　　　}
　　　　public void popupMenuWillBecomeInvisible(PopupMenuEvent pme){
　　　　　　theArea.append("-PopupMenu Invisibel!\n");
　　　　}
　　　　public void popupMenuCanceled(PopupMenuEvent pme){
　　　　　　theArea.append("-PopupMenu Hidden!\n");
　　　　}

　　　　//当某个 JMenuItem 被触发后会在 JTextArea 中加入一个信息。
　　　　public void actionPerformed(ActionEvent ae){
　　　　　　theArea.append("+Popup "+ae.getActionCommand()+" performed!\n");
　　　　}
　　　}//end of inner class PopupPanel
　　}//end of class JPopupMenu1

　　class SwingUtil{
　　　　public static final void setLookAndFeel() {
　　　　　　try{
　　　　　　　　Font font = new Font("JFrame", Font.PLAIN, 12);
　　　　　　　　Enumeration keys = UIManager.getLookAndFeelDefaults().keys();

　　　　　　　　while (keys.hasMoreElements()) {
　　　　　　　　　　Object key = keys.nextElement();
　　　　　　　　　　if (UIManager.get(key) instanceof Font) {
　　　　　　　　　　　　UIManager.put(key, font);
　　　　　　　　　　}
　　　　　　　　}
　　　　　　　　AlloyLookAndFeel.setProperty("alloy.isLookAndFeelFrameDecoration", "true");
　　　　　　　　AlloyTheme theme = new GlassTheme();
　　　　　　　　LookAndFeel alloyLnF = new AlloyLookAndFeel(theme);
　　　　　　　　UIManager.setLookAndFeel(alloyLnF);
　　　　　　}catch(UnsupportedLookAndFeelException ex){
　　　　　　　　ex.printStackTrace();
　　　　　　}
　　　　}
　　}

　 　说明：(1)：由于 JPopupMenu 只是一种 Menu 的组件，因此在使用 JPopupMenu 时我们都需要一个Container 来放置 JPopupMenu，在这里这们选择使用 JPanel 组件来作为 JPopupMenu 的 Container。

　 　(2)：这个程序的运行结果可发现 JPopupMenu 只有在 JTextArea 下缘，也就是 JPanel 的部份才有作用，因为我们并没有在JTextArea中加入 addMouseListener() 方法，你可以在 PopupPanel() 构造函数中加入：

　　theArea.addMouseListener(this);

　　就能够解决在 JTextArea 上无法显示 JPopupMenu 的问题。