java.lang.Object
java.awt.AWTKeyStroke
- すべての実装されたインタフェース:
Serializable
- 直系の既知のサブクラス:
KeyStroke
public class AWTKeyStroke extends Object implements Serializable
キーボードまたは同等の入力デバイス上のキー・アクションを表す
AWTKeyStroke
。 AWTKeyStroke
は、KEY_PRESSED
やKEY_RELEASED KeyEvent
のように、特定のキーを押したり離したりする動作にのみ対応し、KEY_TYPED KeyEvent
のように、特定のJava文字の入力を対応させることもできます。 どのような場合でも、AWTKeyStroke
では、アクションを正確に一致させるために必要な修飾子(Alt、Shift、Control、Meta、AltGraphの各キー、またはこれらのキーの組み合わせ)を指定できます。
AWTKeyStrokes
は不変であり、重複しないことを想定しています。 このため、クライアント・コードで独自のAWTKeyStroke
を定義しないで、getAWTKeyStroke
のバリアントを使います。 このようなファクトリ・メソッドをクライアントで使用すると、AWTKeyStroke
の実装で、インスタンスの効率的なキャッシュと共有が可能です。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
コンストラクタのサマリー
コンストラクタ修飾子コンストラクタ説明protected
デフォルト値を使用してAWTKeyStroke
を構築します。protected
AWTKeyStroke
(char keyChar, int keyCode, int modifiers, boolean onKeyRelease) 指定された値を持つAWTKeyStroke
を構築します。 -
メソッドのサマリー
修飾子と型メソッド説明final boolean
このオブジェクトが指定されたオブジェクトと同じ場合にtrueを返します。static AWTKeyStroke
getAWTKeyStroke
(char keyChar) 指定された文字のKEY_TYPED
イベントを表すAWTKeyStroke
の共有インスタンスを返します。static AWTKeyStroke
getAWTKeyStroke
(int keyCode, int modifiers) 数値キー・コードと修飾子のセットを使用して、AWTKeyStroke
の共有インスタンスを返します。static AWTKeyStroke
getAWTKeyStroke
(int keyCode, int modifiers, boolean onKeyRelease) キーが押されたときと解放されたときのどちらでアクティブになるかを指定して、数値キー・コードと修飾子のセットを使用して、AWTKeyStroke
の共有インスタンスを返します。static AWTKeyStroke
getAWTKeyStroke
(Character keyChar, int modifiers) 指定されたCharacterオブジェクトと修飾子のセットのKEY_TYPED
イベントを表すAWTKeyStroke
の共有インスタンスを返します。static AWTKeyStroke
文字列を解析し、AWTKeyStroke
を返します。static AWTKeyStroke
getAWTKeyStrokeForEvent
(KeyEvent anEvent) 指定されたKeyEvent
を生成したストロークを表すAWTKeyStroke
を返します。final char
このAWTKeyStroke
の文字を返します。final int
このAWTKeyStroke
の数値キー・コードを返します。final int
このAWTKeyStroke
に対応するKeyEvent
のタイプを返します。final int
このAWTKeyStroke
の修飾キーを返します。int
hashCode()
一意であると考えられるこのオブジェクトの数値を返します。この値は、ハッシュ表でインデックス値として使用できます。final boolean
このAWTKeyStroke
がキー解放を表すかどうかを返します。protected Object
このインスタンスに等しい、AWTKeyStroke
のキャッシュされたインスタンス(またはAWTKeyStroke
のサブクラス)を返します。protected static void
registerSubclass
(Class<?> subclass) 非推奨。toString()
このオブジェクトのプロパティを表示および識別する文字列を返します。
-
コンストラクタの詳細
-
AWTKeyStroke
protected AWTKeyStroke()デフォルト値を使用してAWTKeyStroke
を構築します。 次のデフォルト値を使用します。AWTKeyStrokeのデフォルト値 プロパティ デフォルト値 キー文字 KeyEvent.CHAR_UNDEFINED
コード・キー KeyEvent.VK_UNDEFINED
修飾子 none キーを離すとき false
AWTKeyStroke
はクライアント・コードで構築するべきではありません。 代わりに、getAWTKeyStroke
のバリアントを使用します。- 関連項目:
-
AWTKeyStroke
protected AWTKeyStroke(char keyChar, int keyCode, int modifiers, boolean onKeyRelease) 指定された値を持つAWTKeyStroke
を構築します。AWTKeyStroke
はクライアント・コードで構築するべきではありません。 代わりに、getAWTKeyStroke
のバリアントを使用します。- パラメータ:
keyChar
- キーボード・キーの文字値keyCode
- このAWTKeyStroke
のキー・コードmodifiers
- 任意の修飾子のビット単位の論理和の組み合わせonKeyRelease
- このAWTKeyStroke
がキーを離す動作に対応する場合はtrue
、そうでない場合はfalse
- 関連項目:
-
-
メソッドの詳細
-
registerSubclass
@Deprecated protected static void registerSubclass(Class<?> subclass) 非推奨。このメソッドは効果がなく、バイナリの非互換性を避けるために残されています。- パラメータ:
subclass
- ファクトリ・メソッドがインスタンスを生成する新しいクラス
-
getAWTKeyStroke
public static AWTKeyStroke getAWTKeyStroke(char keyChar) 指定された文字のKEY_TYPED
イベントを表すAWTKeyStroke
の共有インスタンスを返します。- パラメータ:
keyChar
- キーボード・キーの文字値- 戻り値:
- そのキーの
AWTKeyStroke
オブジェクト
-
getAWTKeyStroke
public static AWTKeyStroke getAWTKeyStroke(Character keyChar, int modifiers) 指定されたCharacterオブジェクトと修飾子のセットのKEY_TYPED
イベントを表すAWTKeyStroke
の共有インスタンスを返します。 最初のパラメータはchar型ではなくCharacter型のパラメータです。 これは、getAWTKeyStroke(int keyCode, int modifiers)
呼出しによる予期しないクラッシュを避けるためです。 修飾子は、次の組み合わせで構成されます。- java.awt.event.InputEvent.SHIFT_DOWN_MASK
- java.awt.event.InputEvent.CTRL_DOWN_MASK
- java.awt.event.InputEvent.META_DOWN_MASK
- java.awt.event.InputEvent.ALT_DOWN_MASK
- java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK
- java.awt.event.InputEvent.SHIFT_MASK
- java.awt.event.InputEvent.CTRL_MASK
- java.awt.event.InputEvent.META_MASK
- java.awt.event.InputEvent.ALT_MASK
- java.awt.event.InputEvent.ALT_GRAPH_MASK
- パラメータ:
keyChar
- キーボード文字のCharacterオブジェクトmodifiers
- 任意の修飾子のビット単位の論理和の組み合わせ- 戻り値:
- そのキーの
AWTKeyStroke
オブジェクト - 例外:
IllegalArgumentException
-keyChar
がnull
の場合- 関連項目:
-
getAWTKeyStroke
public static AWTKeyStroke getAWTKeyStroke(int keyCode, int modifiers, boolean onKeyRelease) キーが押されたときと解放されたときのどちらでアクティブになるかを指定して、数値キー・コードと修飾子のセットを使用して、AWTKeyStroke
の共有インスタンスを返します。java.awt.event.KeyEvent
で定義された「仮想キー」定数を使用すると、キー・コードを指定できます。 たとえば:java.awt.event.KeyEvent.VK_ENTER
java.awt.event.KeyEvent.VK_TAB
java.awt.event.KeyEvent.VK_SPACE
java.awt.event.KeyEvent.getExtendedKeyCodeForChar
を呼び出すことで、キー・コードを取得することもできます。 修飾子は、次の組み合わせで構成されます。- java.awt.event.InputEvent.SHIFT_DOWN_MASK
- java.awt.event.InputEvent.CTRL_DOWN_MASK
- java.awt.event.InputEvent.META_DOWN_MASK
- java.awt.event.InputEvent.ALT_DOWN_MASK
- java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK
- java.awt.event.InputEvent.SHIFT_MASK
- java.awt.event.InputEvent.CTRL_MASK
- java.awt.event.InputEvent.META_MASK
- java.awt.event.InputEvent.ALT_MASK
- java.awt.event.InputEvent.ALT_GRAPH_MASK
- パラメータ:
keyCode
- キーボード・キーの数値コードを指定するintmodifiers
- 任意の修飾子のビット単位の論理和の組み合わせonKeyRelease
- このAWTKeyStroke
がキーを離す動作を表現する場合はtrue
、そうでない場合はfalse
- 戻り値:
- 上記キーのAWTKeyStrokeオブジェクト
- 関連項目:
-
getAWTKeyStroke
public static AWTKeyStroke getAWTKeyStroke(int keyCode, int modifiers) 数値キー・コードと修飾子のセットを使用して、AWTKeyStroke
の共有インスタンスを返します。 返されるAWTKeyStroke
は、キーを押す動作に対応します。java.awt.event.KeyEvent
で定義された「仮想キー」定数を使用すると、キー・コードを指定できます。 たとえば:java.awt.event.KeyEvent.VK_ENTER
java.awt.event.KeyEvent.VK_TAB
java.awt.event.KeyEvent.VK_SPACE
- java.awt.event.InputEvent.SHIFT_DOWN_MASK
- java.awt.event.InputEvent.CTRL_DOWN_MASK
- java.awt.event.InputEvent.META_DOWN_MASK
- java.awt.event.InputEvent.ALT_DOWN_MASK
- java.awt.event.InputEvent.ALT_GRAPH_DOWN_MASK
- java.awt.event.InputEvent.SHIFT_MASK
- java.awt.event.InputEvent.CTRL_MASK
- java.awt.event.InputEvent.META_MASK
- java.awt.event.InputEvent.ALT_MASK
- java.awt.event.InputEvent.ALT_GRAPH_MASK
- パラメータ:
keyCode
- キーボード・キーの数値コードを指定するintmodifiers
- 任意の修飾子のビット単位の論理和の組み合わせ- 戻り値:
- そのキーの
AWTKeyStroke
オブジェクト - 関連項目:
-
getAWTKeyStrokeForEvent
public static AWTKeyStroke getAWTKeyStrokeForEvent(KeyEvent anEvent) 指定されたKeyEvent
を生成したストロークを表すAWTKeyStroke
を返します。このメソッドは、
KeyTyped
イベントからkeyCharを取得し、KeyPressed
またはKeyReleased
イベントからkeyCodeを取得します。 また、3つのKeyEvent
型のすべてからKeyEvent
修飾子を取得します。- パラメータ:
anEvent
-AWTKeyStroke
を取得するKeyEvent
- 戻り値:
- イベントを発生させた
AWTKeyStroke
- 例外:
NullPointerException
-anEvent
がnullである場合
-
getAWTKeyStroke
public static AWTKeyStroke getAWTKeyStroke(String s) 文字列を解析し、AWTKeyStroke
を返します。 文字列は次の構文を持つ必要があります。<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" => getAWTKeyStroke(KeyEvent.VK_INSERT, 0); "control DELETE" => getAWTKeyStroke(KeyEvent.VK_DELETE, InputEvent.CTRL_MASK); "alt shift X" => getAWTKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK); "alt shift released X" => getAWTKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK | InputEvent.SHIFT_MASK, true); "typed a" => getAWTKeyStroke('a');
- パラメータ:
s
- 上記の構文に従って指定したString- 戻り値:
- 上記文字列の
AWTKeyStroke
オブジェクト - 例外:
IllegalArgumentException
-s
がnull
であるか、フォーマットが正しくない場合
-
getKeyChar
public final char getKeyChar()このAWTKeyStroke
の文字を返します。- 戻り値:
- char値
- 関連項目:
-
getKeyCode
public final int getKeyCode()このAWTKeyStroke
の数値キー・コードを返します。- 戻り値:
- キー・コード値が格納されているint値
- 関連項目:
-
getModifiers
public final int getModifiers()このAWTKeyStroke
の修飾キーを返します。- 戻り値:
- 修飾子が格納されているint値
- 関連項目:
-
isOnKeyRelease
public final boolean isOnKeyRelease()このAWTKeyStroke
がキー解放を表すかどうかを返します。- 戻り値:
- この
AWTKeyStroke
がキーを離す動作を表現する場合はtrue
、そうでない場合はfalse
- 関連項目:
-
getKeyEventType
public final int getKeyEventType()このAWTKeyStroke
に対応するKeyEvent
のタイプを返します。- 戻り値:
KeyEvent.KEY_PRESSED
、KeyEvent.KEY_TYPED
、またはKeyEvent.KEY_RELEASED
- 関連項目:
-
hashCode
public int hashCode()一意であると考えられるこのオブジェクトの数値を返します。この値は、ハッシュ表でインデックス値として使用できます。 -
equals
public final boolean equals(Object anObject) このオブジェクトが指定されたオブジェクトと同じ場合にtrueを返します。 -
toString
public String toString()このオブジェクトのプロパティを表示および識別する文字列を返します。 このメソッドから返されたString
をパラメータとしてgetAWTKeyStroke(String)
に渡して、このキー・ストロークに等しいキー・ストロークを生成します。 -
readResolve
protected Object readResolve() throws ObjectStreamExceptionこのインスタンスに等しい、AWTKeyStroke
のキャッシュされたインスタンス(またはAWTKeyStroke
のサブクラス)を返します。- 戻り値:
- このインスタンスと同じ、キャッシュされたインスタンス
- 例外:
ObjectStreamException
- 直列化の問題が発生した場合
-