javax.swing
クラス KeyStroke

java.lang.Object
  |
  +--javax.swing.KeyStroke

public class KeyStroke

extends Object

implements Serializable

KeyStroke のインスタンスは、キーボードで打たれるキーを表します。このインスタンスは、キーおよび修飾子 (alt、shift、ctrl、meta、またはそれらの組み合わせ) の両方の char コードを保持格納します。

KeyStroke オブジェクトは、ハイレベル (セマンティック) のアクションイベントを定義するために使用されます。すべてのキーストロークをトラップし、関係のないものを破棄する代わりに、注目すべきキーストロークはそれらが登録されているコンポーネントで自動的にアクションを起こします。

KeyStroke オブジェクトは、KeyTyped イベントハンドラでトラップする文字コード生成キーストローク、および KeyPressed イベントハンドラでトラップするキーコード生成キーストローク (Enter キーまたは F1 キーなど) の両方を処理します。

KeyStroke オブジェクトは不変であり、一意です。

すべての KeyStroke オブジェクトはキャッシュされます。KeyStroke オブジェクトを取得するには、getKeyStroke を使用します。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int), getKeyStroke(char), 直列化された形式

メソッドの概要

boolean	equals(Object anObject) このオブジェクトが指定されたオブジェクトと同じ場合に true を返します。
char	getKeyChar() この KeyStroke オブジェクトによって定義されている文字を返します。
int	getKeyCode() この KeyStroke オブジェクトによって定義されている数値キーコードを返します。
static KeyStroke	getKeyStroke(char keyChar) キーが押されたときにアクティブになるキーストロークの共有インスタンスを返します (つまり、KeyEvent.KEY_TYPED イベントの KeyStroke)。
static KeyStroke	getKeyStroke(char keyChar, boolean onKeyRelease) 推奨されません。 getKeyStroke(char) を使用してください。
static KeyStroke	getKeyStroke(int keyCode, int modifiers) 指定された char コードおよび修飾子のセットでキーストロークの共有インスタンスを返します。
static KeyStroke	getKeyStroke(int keyCode, int modifiers, boolean onKeyRelease) 押されたとき、または解放されたときにキーがアクティブになるかどうかを指定して、指定された数値キーコードおよび修飾子のセットでキーストロークの共有インスタンスを返します。
static KeyStroke	getKeyStroke(String representation) 文字列表現と一致するキーストロークの共有インスタンスを返します。
static KeyStroke	getKeyStrokeForEvent(KeyEvent anEvent) イベントからキーストロークを返します。
int	getModifiers() この KeyStroke オブジェクトによって定義されている修飾キーを返します。
int	hashCode() 適宜に一意であると考えられるこのオブジェクトの数値を返します。
boolean	isOnKeyRelease() キーを離したときにこのキーストロークがアクティブになる場合に true を返します。
String	toString() このオブジェクトのプロパティを表示および識別する文字列を返します。

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

メソッドの詳細

getKeyStroke

public static KeyStroke getKeyStroke(char keyChar)

キーが押されたときにアクティブになるキーストロークの共有インスタンスを返します (つまり、KeyEvent.KEY_TYPED イベントの KeyStroke)。

パラメータ:

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

戻り値:

そのキーの KeyStroke オブジェクト

getKeyStroke

public static KeyStroke getKeyStroke(char keyChar,
                                     boolean onKeyRelease)

推奨されません。 getKeyStroke(char) を使用してください。

押されたとき、または解放されたときにキーがアクティブになると見なされるかどうかを指定して、キーストロークの共有インスタンスを返します。

パラメータ:

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

onKeyRelease - boolean 値。true の場合、解放されたときにキーがアクティブであることを指定する

戻り値:

そのキーの KeyStroke オブジェクト

getKeyStroke

public static KeyStroke getKeyStroke(int keyCode,
                                     int modifiers,
                                     boolean onKeyRelease)

押されたとき、または解放されたときにキーがアクティブになるかどうかを指定して、指定された数値キーコードおよび修飾子のセットでキーストロークの共有インスタンスを返します。

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.SHIFT_MASK (1)
• java.awt.Event.CTRL_MASK (2)
• java.awt.Event.META_MASK (4)
• java.awt.Event.ALT_MASK (8)

これらの数字はすべて異なる 2 の累乗であるため、それらの組み合わせは各ビットが別々の修飾キーを表す整数です。

パラメータ:

keyCode - キーボードのキーの数値コードを指定する int 値

modifiers - キー修飾子の組み合わせを指定する int 値

onKeyRelease - boolean 値。true の場合、解放されたときにキーがアクティブであることを指定する

戻り値:

そのキーの KeyStroke オブジェクト

関連項目:

KeyEvent, Event

getKeyStroke

public static KeyStroke getKeyStroke(int keyCode,
                                     int modifiers)

指定された char コードおよび修飾子のセットでキーストロークの共有インスタンスを返します。キーは、押されたときにアクティブになります。

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.SHIFT_MASK (1)
• java.awt.Event.CTRL_MASK (2)
• java.awt.Event.META_MASK (4)
• java.awt.Event.ALT_MASK (8)

これらの数字はすべて異なる 2 の累乗であるため、それらの組み合わせは各ビットが別々の修飾キーを表す整数です。

パラメータ:

keyCode - キーボードのキーの数値コードを指定する int 値

modifiers - キー修飾子の組み合わせを指定する int 値

戻り値:

そのキーの KeyStroke オブジェクト

関連項目:

KeyEvent

getKeyStrokeForEvent

public static KeyStroke getKeyStrokeForEvent(KeyEvent anEvent)

イベントからキーストロークを返します。

このメソッドは KeyTyped イベントから keyChar、KeyPressed または KeyReleased イベントから keyCode を取得するので、イベントの型は重要ではありません。

パラメータ:

anEvent - KeyStroke を取得する KeyEvent

戻り値:

イベントを発生させた KeyStroke

getKeyStroke

public static KeyStroke getKeyStroke(String representation)

文字列表現と一致するキーストロークの共有インスタンスを返します。

パラメータ:

representation - KeyStroke を指定する String

戻り値:

指定と一致する KeyStroke オブジェクト

getKeyChar

public char getKeyChar()

この KeyStroke オブジェクトによって定義されている文字を返します。

戻り値:

char 値

関連項目:

getKeyStroke(char)

getKeyCode

public int getKeyCode()

この KeyStroke オブジェクトによって定義されている数値キーコードを返します。

戻り値:

キーコード値が格納されている int 値

関連項目:

getKeyStroke(int,int)

getModifiers

public int getModifiers()

この KeyStroke オブジェクトによって定義されている修飾キーを返します。

戻り値:

修飾子が格納されている int 値

関連項目:

getKeyStroke(int,int)

isOnKeyRelease

public boolean isOnKeyRelease()

キーを離したときにこのキーストロークがアクティブになる場合に true を返します。

戻り値:

キーを離したときにアクティブになる場合は true、キーを押したときにアクティブになる場合は false

関連項目:

getKeyStroke(int,int,boolean)

hashCode

public int hashCode()

適宜に一意であると考えられるこのオブジェクトの数値を返します。この値は、Hashtable でインデックス値として使用できます。

戻り値:

このオブジェクトを「表す」int 値

オーバーライド:

クラス Object 内の hashCode

関連項目:

Hashtable

equals

public boolean equals(Object anObject)

このオブジェクトが指定されたオブジェクトと同じ場合に true を返します。

パラメータ:

anObject - このオブジェクトと比較する Object

戻り値:

オブジェクトが同じ場合は true

オーバーライド:

クラス Object 内の equals

toString

public String toString()

このオブジェクトのプロパティを表示および識別する文字列を返します。

戻り値:

このオブジェクトの String 表現

オーバーライド:

クラス Object 内の toString