public abstract class KeyCombination extends Object
KeyCodeCombination
)またはキー文字(KeyCharacterCombination
)で指定できます。修飾子キーはshift
、control
、alt
、meta
またはshortcut
で、DOWN
、UP
またはANY
として定義できます。
Shortcut
修飾子は、ホスト・プラットフォームでキーボード・ショートカットに一般に広く使用されている修飾子キーを表すために使用されます。たとえば、WindowsではCtrl
、MacではMeta
(コマンド・キー)などです。Shortcut
修飾子キーを使用することで、開発者はプラットフォームから独立したショートカットを作成できます。そのため、[Shortcut] + [C]のキーの組合せは内部でWindowsでは[Ctrl] + [C]として、Macでは[Meta] + [C]として処理されます。
修飾子と型 | クラスと説明 |
---|---|
static class |
KeyCombination.Modifier
このクラスは、修飾子キーとその値のペアを表します。
|
static class |
KeyCombination.ModifierValue
ModifierValue は、修飾子キーの状態を表します。 |
修飾子と型 | フィールドと説明 |
---|---|
static KeyCombination.Modifier |
ALT_ANY
[Alt] キーを上下いずれかにできることを指定する修飾子。 |
static KeyCombination.Modifier |
ALT_DOWN
[Alt] キーを下にする必要があることを指定する修飾子。 |
static KeyCombination.Modifier |
CONTROL_ANY
[Ctrl] キーを上下いずれかにできることを指定する修飾子。 |
static KeyCombination.Modifier |
CONTROL_DOWN
[Ctrl] キーを下にする必要があることを指定する修飾子。 |
static KeyCombination.Modifier |
META_ANY
[Meta] キーを上下いずれかにできることを指定する修飾子。 |
static KeyCombination.Modifier |
META_DOWN
[Meta] キーを下にする必要があることを指定する修飾子。 |
static KeyCombination |
NO_MATCH
どのイベントにも一致しないKeyCombination。
|
static KeyCombination.Modifier |
SHIFT_ANY
[Shift] キーを上下いずれかにできることを指定する修飾子。 |
static KeyCombination.Modifier |
SHIFT_DOWN
[Shift] キーを下にする必要があることを指定する修飾子。 |
static KeyCombination.Modifier |
SHORTCUT_ANY
[Shortcut] キーを上下いずれかにできることを指定する修飾子。 |
static KeyCombination.Modifier |
SHORTCUT_DOWN
[Shortcut] キーを下にする必要があることを指定する修飾子。 |
修飾子 | コンストラクタと説明 |
---|---|
protected |
KeyCombination(KeyCombination.Modifier... modifiers)
指定された修飾子リストで
KeyCombination を構築します。 |
protected |
KeyCombination(KeyCombination.ModifierValue shift, KeyCombination.ModifierValue control, KeyCombination.ModifierValue alt, KeyCombination.ModifierValue meta, KeyCombination.ModifierValue shortcut)
すべての修飾子キーを明示的に指定して
KeyCombination を構築します。 |
修飾子と型 | メソッドと説明 |
---|---|
boolean |
equals(Object obj)
この
KeyCombination が指定されたオブジェクトと同じであるかどうかをテストします。 |
KeyCombination.ModifierValue |
getAlt()
このキーの組合せの
[Alt] キーの状態。 |
KeyCombination.ModifierValue |
getControl()
このキーの組合せの
[Ctrl] キーの状態。 |
String |
getDisplayText()
ユーザー・インタフェースでの表示(たとえば、メニュー・アイテムの横)に適したこの
KeyCombination の文字列表現を返します。 |
KeyCombination.ModifierValue |
getMeta()
このキーの組合せの
[Meta] キーの状態。 |
String |
getName()
この
KeyCombination の文字列表現を返します。 |
KeyCombination.ModifierValue |
getShift()
このキーの組合せの
[Shift] キーの状態。 |
KeyCombination.ModifierValue |
getShortcut()
このキーの組合せの
[Shortcut] キーの状態。 |
int |
hashCode()
この
KeyCombination のハッシュ・コード値を返します。 |
static KeyCombination |
keyCombination(String name)
指定された文字列から新しい
KeyCombination を構築します。 |
boolean |
match(KeyEvent event)
このキーの組合せが、指定された
KeyEvent での組合せに一致するかどうかをテストします。 |
String |
toString()
このオブジェクトの文字列表現を返します。
|
static KeyCombination |
valueOf(String value)
指定された文字列から新しい
KeyCombination を構築します。 |
public static final KeyCombination.Modifier SHIFT_DOWN
[Shift]
キーを下にする必要があることを指定する修飾子。public static final KeyCombination.Modifier SHIFT_ANY
[Shift]
キーを上下いずれかにできることを指定する修飾子。public static final KeyCombination.Modifier CONTROL_DOWN
[Ctrl]
キーを下にする必要があることを指定する修飾子。public static final KeyCombination.Modifier CONTROL_ANY
[Ctrl]
キーを上下いずれかにできることを指定する修飾子。public static final KeyCombination.Modifier ALT_DOWN
[Alt]
キーを下にする必要があることを指定する修飾子。public static final KeyCombination.Modifier ALT_ANY
[Alt]
キーを上下いずれかにできることを指定する修飾子。public static final KeyCombination.Modifier META_DOWN
[Meta]
キーを下にする必要があることを指定する修飾子。public static final KeyCombination.Modifier META_ANY
[Meta]
キーを上下いずれかにできることを指定する修飾子。public static final KeyCombination.Modifier SHORTCUT_DOWN
[Shortcut]
キーを下にする必要があることを指定する修飾子。public static final KeyCombination.Modifier SHORTCUT_ANY
[Shortcut]
キーを上下いずれかにできることを指定する修飾子。public static final KeyCombination NO_MATCH
protected KeyCombination(KeyCombination.ModifierValue shift, KeyCombination.ModifierValue control, KeyCombination.ModifierValue alt, KeyCombination.ModifierValue meta, KeyCombination.ModifierValue shortcut)
KeyCombination
を構築します。各修飾子キーは、DOWN
、UP
またはANY
に設定できます。shift
- shift
修飾子キーの値control
- ctrl
修飾子キーの値alt
- alt
修飾子キーの値meta
- meta
修飾子キーの値shortcut
- shortcut
修飾子キーの値protected KeyCombination(KeyCombination.Modifier... modifiers)
KeyCombination
を構築します。明示的にリストされていないすべての修飾子キーは、デフォルトのUP
値に設定されます。
デフォルトの修飾子値を変更できる可能性があるすべての修飾子は、KeyCombination
クラスに定数として定義されます。
modifiers
- 修飾子キーとその対応する値のリストpublic final KeyCombination.ModifierValue getShift()
[Shift]
キーの状態。[Shift]
キーの状態。public final KeyCombination.ModifierValue getControl()
[Ctrl]
キーの状態。[Ctrl]
キーの状態。public final KeyCombination.ModifierValue getAlt()
[Alt]
キーの状態。[Alt]
キーの状態。public final KeyCombination.ModifierValue getMeta()
[Meta]
キーの状態。[Meta]
キーの状態。public final KeyCombination.ModifierValue getShortcut()
[Shortcut]
キーの状態。[Shortcut]
キーの状態。public boolean match(KeyEvent event)
KeyEvent
での組合せに一致するかどうかをテストします。
KeyCombination
クラスに実装されているこのメソッドは、修飾子キーに関するテストの一部のみを実行します。テストに主要なキーを含めるには、このメソッドをサブクラスでオーバーライドします。
event
- キー・イベントtrue
、それ以外の場合はfalse
public String getName()
KeyCombination
の文字列表現を返します。
文字列表現は、プラス文字で区切られたセクションで構成されています。各セクションでは、修飾子キーまたは主要なキーを指定します。
修飾子キー・セクションには、修飾子キーのKeyCode
名が含まれています。接頭辞としてIgnored
キーワードを付けることができます。接頭辞のない修飾子キーはDOWN
値を暗黙的に示し、接頭辞付きのバージョンはANY
(IGNORED)値を暗黙的に示します。修飾子キーが文字列に1つも指定されていない場合は、デフォルトのUP
値が設定されます。
キーの組合せ文字列の主要なキー・セクションの形式は、KeyCombination
サブクラスによって異なります。KeyCodeCombination
のキー・コード名か、KeyCharacterCombination
の一重引用符で囲まれたキー文字のいずれかになります。
KeyCombination
文字列表現の例:
"Ctrl+Alt+Q" "Ignore Shift+Ctrl+A" "Alt+'w'"
KeyCombination
の文字列表現public String getDisplayText()
KeyCombination
の文字列表現を返します。KeyCombination
の文字列表現public boolean equals(Object obj)
KeyCombination
が指定されたオブジェクトと同じであるかどうかをテストします。public int hashCode()
KeyCombination
のハッシュ・コード値を返します。public String toString()
getName()
呼出しの結果を返します。public static KeyCombination valueOf(String value)
KeyCombination
を構築します。文字列は、getName
メソッドによって生成されたものと同じ形式である必要があります。
主要なキー・セクション文字列が一重引用符で囲まれている場合、メソッドは引用符で囲まれていない部分文字列用に新しいKeyCharacterCombination
を作成します。それ以外の場合、名前が主要なキー・セクション文字列に対応しているキー・コードを探し、そのコード用にKeyCodeCombination
を作成します。これが行えない場合は、かわりにKeyCharacterCombination
が使用されます。
value
- 要求されたキーの組合せを表す文字列KeyCombination
public static KeyCombination keyCombination(String name)
KeyCombination
を構築します。このメソッドは単にvalueOf(String)
に委任されます。name
- 要求されたキーの組合せを表す文字列KeyCombination
valueOf(String)
Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.