- java.lang.Object
-
- javafx.scene.input.KeyCombination
-
- 已知直接子类:
-
KeyCharacterCombination
,KeyCodeCombination
public abstract class KeyCombination extends Object
表示在键盘快捷键中使用的键组合。 键组合包括一个主键和一组修饰键。 主键可以由其键码 -KeyCodeCombination
或键 -KeyCharacterCombination
。 甲修改键是shift
,control
,alt
,meta
或shortcut
,并且可以被定义为DOWN
,UP
或ANY
。shortcut
修饰符用于表示主机平台上的键盘快捷键常用的修饰符键。 例如,这是control
在Windows和meta
在Mac(命令键)。 通过使用shortcut
键修饰符开发人员可以创建独立于平台的快捷方式。 因此,“快捷键+ C”组合键在Windows内部处理为“Ctrl + C”,Mac处理器为“Meta + C”。- 从以下版本开始:
- JavaFX 2.0
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 static class
KeyCombination.Modifier
此类表示一对修饰符键及其值。static class
KeyCombination.ModifierValue
ModifierValue
指定修饰键的状态。
-
Field Summary
Fields Modifier and Type Field 描述 static KeyCombination.Modifier
ALT_ANY
指定alt
键的alt
可以是向上还是向下。static KeyCombination.Modifier
ALT_DOWN
指定alt
键的alt
必须关闭。static KeyCombination.Modifier
CONTROL_ANY
修饰符指定control
键可以是向上还是向下。static KeyCombination.Modifier
CONTROL_DOWN
指定control
键的control
必须关闭。static KeyCombination.Modifier
META_ANY
修饰符指定meta
键可以是向上还是向下。static KeyCombination.Modifier
META_DOWN
指定meta
键的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
键的shortcut
必须关闭。
-
构造方法摘要
构造方法 Modifier Constructor 描述 protected
KeyCombination(KeyCombination.Modifier... modifiers)
构造具有指定的修饰符列表的KeyCombination
。protected
KeyCombination(KeyCombination.ModifierValue shift, KeyCombination.ModifierValue control, KeyCombination.ModifierValue alt, KeyCombination.ModifierValue meta, KeyCombination.ModifierValue shortcut)
构造一个KeyCombination
,具有所有修饰键的显式规范。
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 boolean
equals(Object obj)
测试这个KeyCombination
是否等于指定的对象。KeyCombination.ModifierValue
getAlt()
alt
键的状态在这个组合键上。KeyCombination.ModifierValue
getControl()
control
键的状态在这个组合键上。String
getDisplayText()
返回适合在用户界面中显示的KeyCombination
的字符串表示(例如,在菜单项旁边)。KeyCombination.ModifierValue
getMeta()
meta
键的这个组合状态。String
getName()
返回此KeyCombination
的字符串表示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
。
-
-
-
字段详细信息
-
SHIFT_DOWN
public static final KeyCombination.Modifier SHIFT_DOWN
指定shift
键的shift
必须关闭。
-
SHIFT_ANY
public static final KeyCombination.Modifier SHIFT_ANY
修饰符指定shift
键可以是向上还是向下。
-
CONTROL_DOWN
public static final KeyCombination.Modifier CONTROL_DOWN
指定control
键的control
必须关闭。
-
CONTROL_ANY
public static final KeyCombination.Modifier CONTROL_ANY
修饰符指定control
键可以是向上还是向下。
-
ALT_DOWN
public static final KeyCombination.Modifier ALT_DOWN
指定alt
键的alt
必须关闭。
-
ALT_ANY
public static final KeyCombination.Modifier ALT_ANY
指定alt
键的alt
可以是向上还是向下。
-
META_DOWN
public static final KeyCombination.Modifier META_DOWN
指定meta
键的meta
必须关闭。
-
META_ANY
public static final KeyCombination.Modifier META_ANY
修饰符指定meta
键可以是向上还是向下。
-
SHORTCUT_DOWN
public static final KeyCombination.Modifier SHORTCUT_DOWN
指定shortcut
键的shortcut
必须关闭。
-
SHORTCUT_ANY
public static final KeyCombination.Modifier SHORTCUT_ANY
指定shortcut
键的shortcut
可以是向上还是向下。
-
NO_MATCH
public static final KeyCombination NO_MATCH
与任何事件匹配的KeyCombination。
-
-
构造方法详细信息
-
KeyCombination
protected KeyCombination(KeyCombination.ModifierValue shift, KeyCombination.ModifierValue control, KeyCombination.ModifierValue alt, KeyCombination.ModifierValue meta, KeyCombination.ModifierValue shortcut)
构造一个KeyCombination
,具有所有修饰键的显式规范。 每个修饰键可设置为DOWN
,UP
或者ANY
。- 参数
-
shift
-shift
修饰键的值 -
control
- 修改键值control
-
alt
- 修改键值alt
-
meta
-meta
修饰键的值 -
shortcut
- 修改键值shortcut
-
KeyCombination
protected KeyCombination(KeyCombination.Modifier... modifiers)
构造具有指定的修饰符列表的KeyCombination
。 未明确列出的所有修饰键都设置为默认值UP
。所有可能修改默认修饰符值的修饰符都定义为
KeyCombination
类中的KeyCombination
。- 参数
-
modifiers
- 修饰键列表及其相应的值
-
-
方法详细信息
-
getShift
public final KeyCombination.ModifierValue getShift()
shift
键的这个组合状态。- 结果
-
shift
键的状态在这个组合键上
-
getControl
public final KeyCombination.ModifierValue getControl()
control
关键在这个组合的状态。- 结果
-
control
键的状态在这个组合键上
-
getAlt
public final KeyCombination.ModifierValue getAlt()
alt
键的状态在这个组合键上。- 结果
-
alt
键的状态在这个组合键上。
-
getMeta
public final KeyCombination.ModifierValue getMeta()
meta
键的状态在这个组合键上。- 结果
-
meta
键的状态在这个组合键上
-
getShortcut
public final KeyCombination.ModifierValue getShortcut()
shortcut
键的状态在这个组合键上。- 结果
-
这个密钥组合中的
shortcut
密钥的状态
-
match
public boolean match(KeyEvent event)
测试此组合是否与给定的KeyEvent
中的组合相匹配。在
KeyCombination
类中实现此方法仅使用修饰键进行部分测试。 这个方法在子类中被覆盖,以便在测试中包含主键。- 参数
-
event
- 关键事件 - 结果
-
true
如果键组合匹配,否则为false
-
getName
public String getName()
返回此KeyCombination
的字符串表示KeyCombination
。字符串表示由加上字符分隔的部分组成。 每个部分指定一个修饰符键或主键。
修饰符键部分包含修改键的
KeyCode
名称。 可以使用Ignored
关键词作为前缀。 非前缀修饰符键意味着其DOWN
值,而前缀版本意味着ANY
(忽略)值。 如果没有在字符串中指定一些修饰符键,则表示它具有默认值UP
。密钥组合字符串的主键部分的格式取决于
KeyCombination
子类。 这无论是对关键代码名称KeyCodeCombination
或单引号键字符KeyCharacterCombination
。KeyCombination
字符串表示的示例:"Ctrl+Alt+Q" "Ignore Shift+Ctrl+A" "Alt+'w'"
- 结果
-
该字符串表示为
KeyCombination
-
getDisplayText
public String getDisplayText()
返回适用于在用户界面中显示的KeyCombination
的字符串表示(例如,在菜单项旁边)。- 结果
-
这个
KeyCombination
字符串表示,适合在用户界面中显示。 - 从以下版本开始:
- JavaFX 8u20
-
equals
public boolean equals(Object obj)
测试这个KeyCombination
是否等于指定的对象。- 重写:
-
equals
在Object
- 参数
-
obj
- 要比较的对象 - 结果
-
true
如果对象相等,否则为false
- 另请参见:
-
Object.hashCode()
,HashMap
-
hashCode
public int hashCode()
返回此KeyCombination
的哈希码值。- 重写:
-
hashCode
在Object
- 结果
- 哈希码值
- 另请参见:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
toString
public String toString()
返回此对象的字符串表示形式。 实现返回getName()
调用的结果。
-
valueOf
public static KeyCombination valueOf(String value)
从指定的字符串构造一个新的KeyCombination
。 字符串的格式应与getName
方法相同。如果主键区字符串用单引号引用,则该方法将为未引用的子字符串创建一个新的
KeyCharacterCombination
。 否则它会找到与主键区字符串相对应的名称的键码,并KeyCodeCombination
创建一个KeyCodeCombination
。 如果这不能完成,可以KeyCharacterCombination
为KeyCharacterCombination
。- 参数
-
value
- 表示所请求的组合键的字符串 - 结果
-
构建了
KeyCombination
- 从以下版本开始:
- JavaFX 2.1
-
keyCombination
public static KeyCombination keyCombination(String name)
从指定的字符串构造一个新的KeyCombination
。 该方法简单地委托给valueOf(String)
。- 参数
-
name
- 表示请求的密钥组合的字符串 - 结果
-
构建了
KeyCombination
- 另请参见:
-
valueOf(String)
-
-