Module  javafx.graphics
软件包  javafx.scene.input

Class 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

    • 构造方法详细信息

      • 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

      • toString

        public String toString​()
        返回此对象的字符串表示形式。 实现返回getName()调用的结果。
        重写：
        toString在 Object
        结果
        该字符串表示为 KeyCombination

      • 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)