public class KeyStroke extends AWTKeyStroke
KeyStroke は、ハイレベル (意味上) のアクションイベントを定義するために使用されます。すべてのキーストロークをトラップし、関係のないものを破棄する代わりに、注目すべきキーストロークはそれらが登録されているコンポーネントで自動的にアクションを起こします。
KeyStroke は不変であり、一意になるように設計されています。クライアントコードで KeyStroke を作成することはできません。代わりに、バリアントの getKeyStroke を使います。これらのファクトリメソッドによって、インスタンスのキャッシュと共有を効率的に行うように KeyStroke を実装できます。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースとの互換性がなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeansTM 用の長期間の格納サポートが java.beans パッケージに追加されています。XMLEncoder を参照してください。
Keymap, getKeyStroke(char)| 修飾子と型 | メソッドと説明 |
|---|---|
static KeyStroke |
getKeyStroke(char keyChar)
指定された文字の
KEY_TYPED イベントを表す KeyStroke の共有インスタンスを返します。 |
static KeyStroke |
getKeyStroke(Character keyChar, int modifiers)
指定された Character オブジェクトと修飾子のセットの
KEY_TYPED イベントを表す KeyStroke の共有インスタンスを返します。 |
static KeyStroke |
getKeyStroke(char keyChar, boolean onKeyRelease)
非推奨。
getKeyStroke(char) を使用
|
static KeyStroke |
getKeyStroke(int keyCode, int modifiers)
数値キーコードおよび修飾子のセットが指定されると、KeyStroke の共有インスタンスを返します。
|
static KeyStroke |
getKeyStroke(int keyCode, int modifiers, boolean onKeyRelease)
数値キーコードおよび修飾子のセットが指定されると、KeyStroke の共有インスタンスを返します。このインスタンスは、キーを押したときまたは放したときにキーがアクティブになるかどうかを示します。
|
static KeyStroke |
getKeyStroke(String s)
文字列の構文を解析し、
KeyStroke を返します。 |
static KeyStroke |
getKeyStrokeForEvent(KeyEvent anEvent)
指定された KeyEvent を生成したストロークを表す KeyStroke を返します。
|
equals, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStroke, getAWTKeyStrokeForEvent, getKeyChar, getKeyCode, getKeyEventType, getModifiers, hashCode, isOnKeyRelease, readResolve, registerSubclass, toStringpublic static KeyStroke getKeyStroke(char keyChar)
KEY_TYPED イベントを表す KeyStroke の共有インスタンスを返します。keyChar - キーボードキーの文字値@Deprecated public static KeyStroke getKeyStroke(char keyChar, boolean onKeyRelease)
keyChar - キーボードキーの文字値onKeyRelease - この KeyStroke がキーを放す動作に対応する場合は true、そうでない場合は false。public static KeyStroke getKeyStroke(Character keyChar, int modifiers)
KEY_TYPED イベントを表す KeyStroke の共有インスタンスを返します。最初のパラメータは char 型ではなく Character 型のパラメータです。これは、不注意による getKeyStroke(int keyCode, int modifiers) 呼び出しとの競合を避けるためです。
修飾子は、次の組み合わせで構成されます。keyChar - キーボード文字の Character オブジェクトmodifiers - 任意の修飾子のビット単位の論理和の組み合わせIllegalArgumentException - keyChar が null の場合InputEventpublic static KeyStroke getKeyStroke(int keyCode, int modifiers, boolean onKeyRelease)
java.awt.event.KeyEvent で定義される「仮想キー」定数は、キーコードを指定するために使用できます。例を示します。
java.awt.event.KeyEvent.getExtendedKeyCodeForChar を呼び出すことで、キーコードを取得することもできます。
修飾子は、次の組み合わせで構成されます。keyCode - キーボードキーの数値コードを指定する intmodifiers - 任意の修飾子のビット単位の論理和の組み合わせonKeyRelease - KeyStroke がキーを放す動作を表す場合は true、そうでない場合は false。KeyEvent, InputEventpublic static KeyStroke getKeyStroke(int keyCode, int modifiers)
java.awt.event.KeyEvent で定義される「仮想キー」定数は、キーコードを指定するために使用できます。例を示します。
java.awt.event.KeyEvent.getExtendedKeyCodeForChar を呼び出すことで、キーコードを取得することもできます。
修飾子は、次の組み合わせで構成されます。keyCode - キーボードキーの数値コードを指定する intmodifiers - 任意の修飾子のビット単位の論理和の組み合わせKeyEvent, InputEventpublic static KeyStroke getKeyStrokeForEvent(KeyEvent anEvent)
このメソッドは、KeyTyped イベントから keyChar を取得し、KeyPressed または KeyReleased イベントから keyCode を取得します。また、3 つの KeyEvent 型のすべてから KeyEvent 修飾子を取得します。
anEvent - KeyStroke の取得元 KeyEventNullPointerException - anEvent が null である場合public static KeyStroke getKeyStroke(String s)
KeyStroke を返します。文字列は次の構文を持つ必要があります。
<modifiers>* (<typedID> | <pressedReleasedID>)
modifiers := shift | control | ctrl | meta | alt | altGraph
typedID := typed <typedKey>
typedKey := string of length 1 giving Unicode character.
pressedReleasedID := (pressed | released) key
key := KeyEvent key code name, i.e. the name following "VK_".
タイプするのか、押すのか、離すのかが指定されない場合、押すと見なされます。いくつか例を挙げます。
"INSERT" => getKeyStroke(KeyEvent.VK_INSERT, 0);
"control DELETE" => getKeyStroke(KeyEvent.VK_DELETE, InputEvent.CTRL_MASK);
"alt shift X" => getKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK);
"alt shift released X" => getKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK, true);
"typed a" => getKeyStroke('a');
下位互換性を維持するため、String が null または構文誤りの場合、null が戻ります。s - 上記の構文に従って指定した StringKeyEvent バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.