AWTKeyStroke (Java Platform SE 8)

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

関連項目:

getAWTKeyStroke(char), 直列化された形式

コンストラクタのサマリー

コンストラクタ
修飾子	コンストラクタ	説明
`protected`	`AWTKeyStroke()`	デフォルト値を使用して`AWTKeyStroke`を構築します。
`protected`	`AWTKeyStroke(char keyChar, int keyCode, int modifiers, boolean onKeyRelease)`	指定された値を持つ`AWTKeyStroke`を構築します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`boolean`	`equals(Object anObject)`	このオブジェクトが指定されたオブジェクトと同じ場合にtrueを返します。
`static AWTKeyStroke`	`getAWTKeyStroke(char keyChar)`	指定された文字の`KEY_TYPED`イベントを表す`AWTKeyStroke`の共有インスタンスを返します。
`static AWTKeyStroke`	`getAWTKeyStroke(Character keyChar, int modifiers)`	指定されたCharacterオブジェクトと修飾子のセットの`KEY_TYPED`イベントを表す`AWTKeyStroke`の共有インスタンスを返します。
`static AWTKeyStroke`	`getAWTKeyStroke(int keyCode, int modifiers)`	数値キー・コードと修飾子のセットを使用して、`AWTKeyStroke`の共有インスタンスを返します。
`static AWTKeyStroke`	`getAWTKeyStroke(int keyCode, int modifiers, boolean onKeyRelease)`	キーが押されたときと解放されたときのどちらでアクティブになるかを指定して、数値キー・コードと修飾子のセットを使用して、`AWTKeyStroke`の共有インスタンスを返します。
`static AWTKeyStroke`	`getAWTKeyStroke(String s)`	文字列を解析し、`AWTKeyStroke`を返します。
`static AWTKeyStroke`	`getAWTKeyStrokeForEvent(KeyEvent anEvent)`	特定の`KeyEvent`を生成したストロークを表す`AWTKeyStroke`を返します。
`char`	`getKeyChar()`	この`AWTKeyStroke`の文字を返します。
`int`	`getKeyCode()`	この`AWTKeyStroke`の数値キー・コードを返します。
`int`	`getKeyEventType()`	この`AWTKeyStroke`に対応する`KeyEvent`のタイプを返します。
`int`	`getModifiers()`	この`AWTKeyStroke`の修飾キーを返します。
`int`	`hashCode()`	一意であると考えられるこのオブジェクトの数値を返します。この値は、ハッシュ表でインデックス値として使用できます。
`boolean`	`isOnKeyRelease()`	この`AWTKeyStroke`がキー解放を表すかどうかを返します。
`protected Object`	`readResolve()`	このインスタンスに等しい、`AWTKeyStroke`のキャッシュされたインスタンス(または`AWTKeyStroke`のサブクラス)を返します。
`protected static void`	`registerSubclass(Class<?> subclass)`	`AWTKeyStroke`の新しいインスタンスを生成するときに、`AWTKeyStroke`のファクトリ・メソッドが使用する新しいクラスを登録します。
`String`	`toString()`	このオブジェクトのプロパティを表示および識別する文字列を返します。

クラス java.lang.Objectから継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

AWTKeyStroke

protected AWTKeyStroke()

デフォルト値を使用してAWTKeyStrokeを構築します。次のデフォルト値を使用します。

プロパティ	デフォルト値
キー文字	`KeyEvent.CHAR_UNDEFINED`
キー・コード	`KeyEvent.VK_UNDEFINED`
修飾子	なし
キーを離すとき	`false`

AWTKeyStrokeはクライアント・コードで構築するべきではありません。代わりに、getAWTKeyStrokeのバリアントを使用します。

関連項目:: getAWTKeyStroke(char)

AWTKeyStroke
```
protected AWTKeyStroke(char keyChar,
                       int keyCode,
                       int modifiers,
                       boolean onKeyRelease)
```
指定された値でAWTKeyStrokeを構築します。 AWTKeyStrokeはクライアント・コードで構築するべきではありません。代わりに、getAWTKeyStrokeのバリアントを使用します。

パラメータ:

keyChar - キーボード・キーの文字値

keyCode - このAWTKeyStrokeのキー・コード

modifiers - 任意の修飾子のビット単位の論理和の組み合わせ

onKeyRelease - このAWTKeyStrokeがキーを離す動作に対応する場合はtrue、そうでない場合はfalse

関連項目:

getAWTKeyStroke(char)

メソッドの詳細
- registerSubclass
```
protected static void registerSubclass(Class<?> subclass)
```
  AWTKeyStrokeの新しいインスタンスを生成するときに、AWTKeyStrokeのファクトリ・メソッドが使用する新しいクラスを登録します。このメソッドを呼び出したあと、ファクトリ・メソッドは指定されたクラスのインスタンスを返します。指定するクラスはAWTKeyStrokeかAWTKeyStrokeから派生したもののどちらかで、引数なしのコンストラクタを持たなければいけません。コンストラクタのアクセス可能性は任意であり、privateでも構いません。この操作は現在のAWTKeyStrokeキャッシュをフラッシュします。
  
  パラメータ:
  
  subclass - ファクトリ・メソッドがインスタンスを生成する新しいクラス
  
  例外:
  
  IllegalArgumentException - サブクラスがnullであるか、または引数なしのコンストラクタを持たない場合
  
  ClassCastException - サブクラスがAWTKeyStrokeでない場合、またはAWTKeyStrokeから派生したクラスでない場合
- 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
  次に示す古い修飾子も使用できますが、これらは_DOWN_修飾子にマッピングされます。
  - 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
  これらも使用できますが、これらは_DOWN_修飾子にマッピングされます。これらの数字はすべて異なる2の累乗であるため、それらの組み合わせは各ビットが別々の修飾キーを表す整数です。修飾子を指定しない場合は、0を使います。
  パラメータ:
  
  keyChar - キーボード文字のCharacterオブジェクト
  
  modifiers - 任意の修飾子のビット単位の論理和の組み合わせ
  
  戻り値:
  
  そのキーのAWTKeyStrokeオブジェクト
  
  例外:
  
  IllegalArgumentException - keyCharがnullの場合
  
  関連項目:
  
  InputEvent
- 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
  これらも使用できますが、これらは_DOWN_修飾子にマッピングされます。これらの数字はすべて異なる2の累乗であるため、それらの組み合わせは各ビットが別々の修飾キーを表す整数です。修飾子を指定しない場合は、0を使います。
  パラメータ:
  
  keyCode - キーボード・キーの数値コードを指定するint
  
  modifiers - 任意の修飾子のビット単位の論理和の組み合わせ
  
  onKeyRelease - このAWTKeyStrokeがキーを離す動作を表現する場合はtrue、そうでない場合はfalse
  
  戻り値:
  
  上記キーのAWTKeyStrokeオブジェクト
  
  関連項目:
  
  KeyEvent, InputEvent
- 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
  これらも使用できますが、これらは_DOWN_修飾子にマッピングされます。これらの数字はすべて異なる2の累乗であるため、それらの組み合わせは各ビットが別々の修飾キーを表す整数です。修飾子を指定しない場合は、0を使います。
  パラメータ:
  
  keyCode - キーボード・キーの数値コードを指定するint
  
  modifiers - 任意の修飾子のビット単位の論理和の組み合わせ
  
  戻り値:
  
  そのキーのAWTKeyStrokeオブジェクト
  
  関連項目:
  
  KeyEvent, InputEvent
- 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値
  
  関連項目:
  
  getAWTKeyStroke(char), KeyEvent.getKeyChar()
- getKeyCode
```
public final int getKeyCode()
```
  このAWTKeyStrokeの数値キー・コードを返します。
  
  戻り値:
  
  キー・コード値が格納されているint値
  
  関連項目:
  
  getAWTKeyStroke(int,int), KeyEvent.getKeyCode()
- getModifiers
```
public final int getModifiers()
```
  このAWTKeyStrokeの修飾キーを返します。
  
  戻り値:
  
  修飾子が格納されているint値
  
  関連項目:
  
  getAWTKeyStroke(int,int)
- isOnKeyRelease
```
public final boolean isOnKeyRelease()
```
  このAWTKeyStrokeがキー解放を表すかどうかを返します。
  
  戻り値:
  
  このAWTKeyStrokeがキーを離す動作を表現する場合はtrue、そうでない場合はfalse
  
  関連項目:
  
  getAWTKeyStroke(int,int,boolean)
- getKeyEventType
```
public final int getKeyEventType()
```
  このAWTKeyStrokeに対応するKeyEventのタイプを返します。
  
  戻り値:
  
  KeyEvent.KEY_PRESSED、KeyEvent.KEY_TYPED、またはKeyEvent.KEY_RELEASED
  
  関連項目:
  
  KeyEvent
- hashCode
```
public int hashCode()
```
  一意であると考えられるこのオブジェクトの数値を返します。この値は、ハッシュ表でインデックス値として使用できます。
  
  オーバーライド:
  
  hashCode、クラスObject
  
  戻り値:
  
  このオブジェクトを表すint値
  
  関連項目:
  
  Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
- equals
```
public final boolean equals(Object anObject)
```
  このオブジェクトが指定されたオブジェクトと同じ場合にtrueを返します。
  
  オーバーライド:
  
  equals、クラスObject
  
  パラメータ:
  
  anObject - このオブジェクトと比較するオブジェクト
  
  戻り値:
  
  オブジェクトが同じ場合はtrue
  
  関連項目:
  
  Object.hashCode(), HashMap
- toString
```
public String toString()
```
  このオブジェクトのプロパティを表示および識別する文字列を返します。このメソッドから返されたStringをパラメータとしてgetAWTKeyStroke(String)に渡して、このキー・ストロークに等しいキー・ストロークを生成します。
  
  オーバーライド:
  
  toString、クラスObject
  
  戻り値:
  
  このオブジェクトの文字列表現
  
  関連項目:
  
  getAWTKeyStroke(String)
- readResolve
```
protected Object readResolve()
                      throws ObjectStreamException
```
  このインスタンスに等しい、AWTKeyStrokeのキャッシュされたインスタンス(またはAWTKeyStrokeのサブクラス)を返します。
  
  戻り値:
  
  このインスタンスと同じ、キャッシュされたインスタンス
  
  例外:
  
  ObjectStreamException

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスAWTKeyStroke

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

AWTKeyStroke

AWTKeyStroke

メソッドの詳細

registerSubclass

getAWTKeyStroke

getAWTKeyStroke

getAWTKeyStroke

getAWTKeyStroke

getAWTKeyStrokeForEvent

getAWTKeyStroke

getKeyChar

getKeyCode

getModifiers

isOnKeyRelease

getKeyEventType

hashCode

equals

toString

readResolve