メニューのキーボードニーモニックの設定

メニューに対してキーボードニーモニックを設定する方法を確認します。キーボードニーモニックとはメニュー一つ一つに特定のキーを割り当て、そのキーが押されたらメニューがクリックされたのと同じ扱いをするものです。

メニューにキーボードニーモニックを設定するにはJMenuクラスの親クラスであるAbstractButtonクラスで定義されているsetMnemonicメソッドを使います。

setMnemonic
public void setMnemonic(int mnemonic)

現在のモデルにキーボードニーモニックを設定します。ニーモニックは、フォーカスがこのボタンの
上位ウィンドウのどこかにある場合に、Look & Feel のマウスなし修飾子 (通常は Alt) と組み合わ
せて、このボタンを有効化するキーです。

ニーモニックはキーボード上の 1 つのキーに対応している必要があり、java.awt.event.KeyEvent 
で定義される VK_XXX キーコードのどれかを使用して指定します。大文字、小文字は区別されないた
め、対応するキーコードのキーイベントは、Shift キーが押されているかどうかにかかわらず、ボタ
ンを有効化します。

ニーモニックで定義されている文字がボタンのラベル文字列にある場合は、その最初の文字に下線が
付けられ、ニーモニックであることをユーザーに知らせます。

パラメータ:
  mnemonic - ニーモニックを表すキーコード

引数にはメニューに設定したいキーを表す値を指定します。値はint型の数値で指定しますが、指定できる値は java.awt.event.KeyEventクラスで定義されています。キーボード上のキーに対応する値がほとんど定義されていますが数が非常に多いので数値とアルファベットだけご紹介します。

数値：
KeyEvent.VK_0 から KeyEvent.VK_9

アルファベット：
KeyEvent.VK_A から KeyEvent.VK_Z

例えば「KeyEvent.VK_A」を設定した場合、ALT＋「a」を押すとニーモニックが設定されたメニューが押された状態になります。(大文字小文字は関係ないのでALT＋「A」でも同じです)。

実際の使い方は次のようになります。

JMenu menu1 = new JMenu("File");
JMenu menu2 = new JMenu("Edit");
menu1.setMnemonic(KeyEvent.VK_F);
menu2.setMnemonic(KeyEvent.VK_E);

なお、ニーモニックに設定した文字がメニューの文字列に含まれている場合には、メニューに表示されている文字列の該当の文字の下にアンダーバーが表示されます。またニーモニックに設定した文字がメニューに複数含まれている場合は、最初に現れた文字にだけアンダーバーが表示されます。

サンプルプログラム

では実際に試してみます。

SSample10_1.java

import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JButton;
import javax.swing.JMenuBar;
import javax.swing.JMenu;
import javax.swing.JMenuItem;
import java.awt.Container;
import java.awt.BorderLayout;
import java.awt.event.KeyEvent;

class SSample10_1 extends JFrame{
  public static void main(String args[]){
    SSample10_1 frame = new SSample10_1("タイトル");
    frame.setVisible(true);
  }

  SSample10_1(String title){
    setTitle(title);
    setBounds(100, 100, 300, 250);
    setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

    JMenuBar menubar = new JMenuBar();
    JMenu menu1 = new JMenu("File");
    JMenu menu2 = new JMenu("Edit");
    JMenu menu3 = new JMenu("Tool");
    JMenu menu4 = new JMenu("Help");

    menu1.setMnemonic(KeyEvent.VK_F);
    menu2.setMnemonic(KeyEvent.VK_E);
    menu3.setMnemonic(KeyEvent.VK_O);
    menu4.setMnemonic(KeyEvent.VK_H);

    menubar.add(menu1);
    menubar.add(menu2);
    menubar.add(menu3);
    menubar.add(menu4);

    JMenuItem menuitem1_1 = new JMenuItem("New");
    JMenuItem menuitem1_2 = new JMenuItem("Open");
    JMenuItem menuitem1_3 = new JMenuItem("Close");

    menu1.add(menuitem1_1);
    menu1.add(menuitem1_2);
    menu1.add(menuitem1_3);

    JMenuItem menuitem2_1 = new JMenuItem("Cut");
    JMenuItem menuitem2_2 = new JMenuItem("Copy");
    JMenuItem menuitem2_3 = new JMenuItem("Paste");

    menu2.add(menuitem2_1);
    menu2.add(menuitem2_3);
    menu2.insert(menuitem2_2, 1);

    setJMenuBar(menubar);

    JPanel p = new JPanel();

    JButton button = new JButton("button");
    p.add(button);

    Container contentPane = getContentPane();
    contentPane.add(p, BorderLayout.CENTER);
  }
}

ではコンパイルを行った上で実行してみます。

4つのメニューにそれぞれキーボードニーモニックを設定してあります。3つ目のメニューにはキーボードニーモニックとして"O"を設定してありますが、2つある"o"の中の最初の"o"の下に下線が引かれています。

ではALT＋「F」を押してみます。

「File」メニューがクリックされたのと同じ扱いとなります。