JavaのJPopupMenuで右クリックメニュー（コンテキストメニュー）を実装する方法

Java SwingのJPopupMenuを使うと、マウスの右ボタンがクリックされたタイミングで、画面上の任意の場所にポップアップメニュー（コンテキストメニュー）を表示できます。

JPopupMenuの基本

• ポップアップメニューは、インボーカー（invoker）と呼ばれる基盤となるコンポーネントに関連付けられた自由配置型のメニューです。
• 多くの場合、ポップアップメニューは特定のコンポーネントに紐付けられ、状況に応じた選択肢（コンテキスト依存の操作）を表示するために使用されます。
• ポップアップメニューを作成するにはJPopupMenuクラスを使用し、通常のメニューと同じようにJMenuItemを追加できます。
• メニューを表示するにはshow()メソッドを呼び出します。一般的にはマウスイベントへの反応として呼び出されます。

ポイント：isPopupTrigger()メソッド

受け取ったマウスイベントがポップアップメニューを表示すべきものかどうかを判定するには、MouseEventクラスのisPopupTrigger()メソッドを使用します。OSによって右クリックを検出するタイミング（mousePressed／mouseReleased）が異なるため、このメソッドを利用することでプラットフォームに依存しない実装が可能になります。

サンプルコード

import java.awt.event.*;
import java.awt.*;
import javax.swing.*;

public class JPopupMenuTest extends JFrame {
    private JPopupMenu popup;

    public JPopupMenuTest() {
        setTitle("JPopupMenu Test");
        Container contentPane = getContentPane();
        popup = new JPopupMenu();

        // ポップアップメニューに項目を追加
        popup.add(new JMenuItem("Cut"));
        popup.add(new JMenuItem("Copy"));
        popup.add(new JMenuItem("Paste"));
        popup.addSeparator();
        popup.add(new JMenuItem("SelectAll"));

        contentPane.addMouseListener(new MouseAdapter() {
            public void mouseReleased(MouseEvent me) {
                showPopup(me); // showPopup() は独自に定義したメソッド
            }
        });

        setSize(375, 250);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setLocationRelativeTo(null);
        setVisible(true);
    }

    void showPopup(MouseEvent me) {
        if (me.isPopupTrigger())
            popup.show(me.getComponent(), me.getX(), me.getY());
    }

    public static void main(String args[]) {
        new JPopupMenuTest();
    }
}

実行結果

プログラムを実行してフレーム上で右クリックすると、「Cut」「Copy」「Paste」「SelectAll」の各項目を持つポップアップメニューが、クリックした位置に表示されます。