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

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

チェックボックスにキーボードニーモニックを設定するにはJCheckBoxクラスの親クラスである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_N」を設定した場合、ALT＋「n」を押すとニーモニックが設定されたボタンが押された状態になります。(大文字小文字は関係ないのでALT＋「N」でも同じです)。

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

JCheckBox checkbox = new JCheckBox("チェックボックス");
checkbox.setMnemonic(KeyEvent.VK_N);

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

サンプルプログラム

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

SSample12_1.java

import javax.swing.JFrame;
import javax.swing.JPanel;
import javax.swing.JCheckBox;
import java.awt.Container;
import java.awt.BorderLayout;
import java.awt.event.KeyEvent;

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

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

    JPanel p = new JPanel();

    JCheckBox ckbox1 = new JCheckBox("Orange");
    ckbox1.setMnemonic(KeyEvent.VK_O);
    JCheckBox ckbox2 = new JCheckBox("Melon");
    ckbox2.setMnemonic(KeyEvent.VK_M);
    JCheckBox ckbox3 = new JCheckBox("Grape");
    ckbox3.setMnemonic(KeyEvent.VK_G);

    p.add(ckbox1);
    p.add(ckbox2);
    p.add(ckbox3);

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

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

3つのチェックボックスを表示しています。各チェックボックスにはキーボードニーモニックが設定してあり、対応する文字の下には下線が表示されています。

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

対応する中央のチェックボックスが押されたのと同じ扱いになります。

JavaDrive