public class KeyStroke extends AWTKeyStroke
KeyStrokeは、ハイレベル(意味上)のアクション・イベントを定義するために使用されます。 すべてのキー・ストロークをトラップし、関係のないものを破棄する代わりに、注目すべきキー・ストロークはそれらが登録されているコンポーネントで自動的にアクションを起こします。
KeyStrokeは不変であり、一意であることが想定されています。 クライアント・コードではKeyStrokeを作成できません。かわりに、getKeyStrokeのバリアントを使用する必要があります。 これらのファクトリ・メソッドによって、インスタンスのキャッシュと共有を効率的に行うようにKeyStrokeを実装できます。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースとの互換性がなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4以降、すべてのJavaBeans™用の長期間の格納サポートが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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。