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

Class KeyCombination

  • 已知直接子类:
    KeyCharacterCombinationKeyCodeCombination


    public abstract class KeyCombination
    extends Object
    表示在键盘快捷键中使用的键组合。 键组合包括一个主键和一组修饰键。 主键可以由其键码 - KeyCodeCombination或键 - KeyCharacterCombination 甲修改键是shiftcontrolaltmetashortcut ,并且可以被定义为DOWNUPANY

    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是否等于指定的对象。
        重写:
        equalsObject
        参数
        obj - 要比较的对象
        结果
        true如果对象相等,否则为 false
        另请参见:
        Object.hashCode()HashMap
      • toString

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

        public static KeyCombination valueOf​(String value)
        从指定的字符串构造一个新的KeyCombination 字符串的格式应与getName方法相同。

        如果主键区字符串用单引号引用,则该方法将为未引用的子字符串创建一个新的KeyCharacterCombination 否则它会找到与主键区字符串相对应的名称的键码,并KeyCodeCombination创建一个KeyCodeCombination 如果这不能完成,可以KeyCharacterCombinationKeyCharacterCombination

        参数
        value - 表示所请求的组合键的字符串
        结果
        构建了 KeyCombination
        从以下版本开始:
        JavaFX 2.1
      • keyCombination

        public static KeyCombination keyCombination​(String name)
        从指定的字符串构造一个新的KeyCombination 该方法简单地委托给valueOf(String)
        参数
        name - 表示请求的密钥组合的字符串
        结果
        构建了 KeyCombination
        另请参见:
        valueOf(String)