KeyCombination

java.lang.Object
- javafx.scene.input.KeyCombination

Direct Known Subclasses:

KeyCharacterCombination, KeyCodeCombination
```
public abstract class KeyCombination
extends java.lang.Object
```
Represents a combination of keys which are used in keyboard shortcuts. A key combination consists of a main key and a set of modifier keys. The main key can be specified by its key code - KeyCodeCombination or key character - KeyCharacterCombination. A modifier key is shift, control, alt, meta or shortcut and can be defined as DOWN, UP or ANY.
The shortcut modifier is used to represent the modifier key which is used commonly in keyboard shortcuts on the host platform. This is for example control on Windows and meta (command key) on Mac. By using shortcut key modifier developers can create platform independent shortcuts. So the "Shortcut+C" key combination is handled internally as "Ctrl+C" on Windows and "Meta+C" on Mac.

Since:

JavaFX 2.0

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`KeyCombination.Modifier` This class represents a pair of modifier key and its value.
`static class`	`KeyCombination.ModifierValue` `ModifierValue` specifies state of modifier keys.

Field Summary

Fields
Modifier and Type	Field and Description
`private KeyCombination.ModifierValue`	`alt` The state of the `alt` key in this key combination.
`static KeyCombination.Modifier`	`ALT_ANY` Modifier which specifies that the `alt` key can be either up or down.
`static KeyCombination.Modifier`	`ALT_DOWN` Modifier which specifies that the `alt` key must be down.
`private KeyCombination.ModifierValue`	`control` The state of the `control` key in this key combination.
`static KeyCombination.Modifier`	`CONTROL_ANY` Modifier which specifies that the `control` key can be either up or down.
`static KeyCombination.Modifier`	`CONTROL_DOWN` Modifier which specifies that the `control` key must be down.
`private KeyCombination.ModifierValue`	`meta` The state of the `meta` key in this key combination.
`static KeyCombination.Modifier`	`META_ANY` Modifier which specifies that the `meta` key can be either up or down.
`static KeyCombination.Modifier`	`META_DOWN` Modifier which specifies that the `meta` key must be down.
`static KeyCombination`	`NO_MATCH` A KeyCombination that will match with no events.
`private static KeyCombination.Modifier[]`	`POSSIBLE_MODIFIERS`
`private KeyCombination.ModifierValue`	`shift` The state of the `shift` key in this key combination.
`static KeyCombination.Modifier`	`SHIFT_ANY` Modifier which specifies that the `shift` key can be either up or down.
`static KeyCombination.Modifier`	`SHIFT_DOWN` Modifier which specifies that the `shift` key must be down.
`private KeyCombination.ModifierValue`	`shortcut` The state of the `shortcut` key in this key combination.
`static KeyCombination.Modifier`	`SHORTCUT_ANY` Modifier which specifies that the `shortcut` key can be either up or down.
`static KeyCombination.Modifier`	`SHORTCUT_DOWN` Modifier which specifies that the `shortcut` key must be down.

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`KeyCombination(KeyCombination.Modifier... modifiers)` Constructs a `KeyCombination` with the specified list of modifiers.
`protected`	`KeyCombination(KeyCombination.ModifierValue shift, KeyCombination.ModifierValue control, KeyCombination.ModifierValue alt, KeyCombination.ModifierValue meta, KeyCombination.ModifierValue shortcut)` Constructs a `KeyCombination` with an explicit specification of all modifier keys.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private static void`	`addModifierIntoString(java.lang.StringBuilder sb, KeyCode modifierKey, KeyCombination.ModifierValue modifierValue)`
`private void`	`addModifiersIntoString(java.lang.StringBuilder sb)`
`boolean`	`equals(java.lang.Object obj)` Tests whether this `KeyCombination` equals to the specified object.
`KeyCombination.ModifierValue`	`getAlt()` The state of the `alt` key in this key combination.
`KeyCombination.ModifierValue`	`getControl()` The state of the `control` key in this key combination.
`java.lang.String`	`getDisplayText()` Returns a string representation of this `KeyCombination` that is suitable for display in a user interface (for example, beside a menu item).
`KeyCombination.ModifierValue`	`getMeta()` The state of the `meta` key in this key combination.
`(package private) static KeyCombination.Modifier`	`getModifier(java.lang.String name)`
`private static KeyCombination.ModifierValue`	`getModifierValue(KeyCombination.Modifier[] modifiers, KeyCode modifierKey)`
`java.lang.String`	`getName()` Returns a string representation of this `KeyCombination`.
`KeyCombination.ModifierValue`	`getShift()` The state of the `shift` key in this key combination.
`KeyCombination.ModifierValue`	`getShortcut()` The state of the `shortcut` key in this key combination.
`int`	`hashCode()` Returns a hash code value for this `KeyCombination`.
`static KeyCombination`	`keyCombination(java.lang.String name)` Constructs a new `KeyCombination` from the specified string.
`boolean`	`match(KeyEvent event)` Tests whether this key combination matches the combination in the given `KeyEvent`.
`private static java.lang.String`	`normalizeToken(java.lang.String token)`
`private static KeyCombination.ModifierValue`	`resolveModifierValue(KeyCombination.ModifierValue firstValue, KeyCombination.ModifierValue secondValue)`
`private static java.lang.String[]`	`splitName(java.lang.String name)`
`private static boolean`	`test(KeyCode testedModifierKey, KeyCombination.ModifierValue testedModifierValue, KeyCode shortcutModifierKey, KeyCombination.ModifierValue shortcutModifierValue, boolean isKeyDown)`
`private static boolean`	`test(KeyCombination.ModifierValue modifierValue, boolean isDown)`
`java.lang.String`	`toString()` Returns a string representation of this object.
`static KeyCombination`	`valueOf(java.lang.String value)` Constructs a new `KeyCombination` from the specified string.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - SHIFT_DOWN
```
public static final KeyCombination.Modifier SHIFT_DOWN
```
    Modifier which specifies that the shift key must be down.
  - SHIFT_ANY
```
public static final KeyCombination.Modifier SHIFT_ANY
```
    Modifier which specifies that the shift key can be either up or down.
  - CONTROL_DOWN
```
public static final KeyCombination.Modifier CONTROL_DOWN
```
    Modifier which specifies that the control key must be down.
  - CONTROL_ANY
```
public static final KeyCombination.Modifier CONTROL_ANY
```
    Modifier which specifies that the control key can be either up or down.
  - ALT_DOWN
```
public static final KeyCombination.Modifier ALT_DOWN
```
    Modifier which specifies that the alt key must be down.
  - ALT_ANY
```
public static final KeyCombination.Modifier ALT_ANY
```
    Modifier which specifies that the alt key can be either up or down.
  - META_DOWN
```
public static final KeyCombination.Modifier META_DOWN
```
    Modifier which specifies that the meta key must be down.
  - META_ANY
```
public static final KeyCombination.Modifier META_ANY
```
    Modifier which specifies that the meta key can be either up or down.
  - SHORTCUT_DOWN
```
public static final KeyCombination.Modifier SHORTCUT_DOWN
```
    Modifier which specifies that the shortcut key must be down.
  - SHORTCUT_ANY
```
public static final KeyCombination.Modifier SHORTCUT_ANY
```
    Modifier which specifies that the shortcut key can be either up or down.
  - POSSIBLE_MODIFIERS
```
private static final KeyCombination.Modifier[] POSSIBLE_MODIFIERS
```
  - NO_MATCH
```
public static final KeyCombination NO_MATCH
```
    A KeyCombination that will match with no events.
  - shift
```
private final KeyCombination.ModifierValue shift
```
    The state of the shift key in this key combination.
  - control
```
private final KeyCombination.ModifierValue control
```
    The state of the control key in this key combination.
  - alt
```
private final KeyCombination.ModifierValue alt
```
    The state of the alt key in this key combination.
  - meta
```
private final KeyCombination.ModifierValue meta
```
    The state of the meta key in this key combination.
  - shortcut
```
private final KeyCombination.ModifierValue shortcut
```
    The state of the shortcut key in this key combination.
- Constructor Detail
  - KeyCombination
```
protected KeyCombination(KeyCombination.ModifierValue shift,
                         KeyCombination.ModifierValue control,
                         KeyCombination.ModifierValue alt,
                         KeyCombination.ModifierValue meta,
                         KeyCombination.ModifierValue shortcut)
```
    Constructs a KeyCombination with an explicit specification of all modifier keys. Each modifier key can be set to DOWN, UP or ANY.
    
    Parameters:
    
    shift - the value of the shift modifier key
    
    control - the value of the control modifier key
    
    alt - the value of the alt modifier key
    
    meta - the value of the meta modifier key
    
    shortcut - the value of the shortcut modifier key
  - KeyCombination
```
protected KeyCombination(KeyCombination.Modifier... modifiers)
```
    Constructs a KeyCombination with the specified list of modifiers. All modifier keys which are not explicitly listed are set to the default UP value.
    All possible modifiers which change the default modifier value are defined as constants in the KeyCombination class.
    
    Parameters:
    
    modifiers - the list of modifier keys and their corresponding values
- Method Detail
  - getShift
```
public final KeyCombination.ModifierValue getShift()
```
    The state of the shift key in this key combination.
    
    Returns:
    
    The state of the shift key in this key combination
  - getControl
```
public final KeyCombination.ModifierValue getControl()
```
    The state of the control key in this key combination.
    
    Returns:
    
    The state of the control key in this key combination
  - getAlt
```
public final KeyCombination.ModifierValue getAlt()
```
    The state of the alt key in this key combination.
    
    Returns:
    
    The state of the alt key in this key combination.
  - getMeta
```
public final KeyCombination.ModifierValue getMeta()
```
    The state of the meta key in this key combination.
    
    Returns:
    
    The state of the meta key in this key combination
  - getShortcut
```
public final KeyCombination.ModifierValue getShortcut()
```
    The state of the shortcut key in this key combination.
    
    Returns:
    
    The state of the shortcut key in this key combination
  - match
```
public boolean match(KeyEvent event)
```
    Tests whether this key combination matches the combination in the given KeyEvent.
    The implementation of this method in the KeyCombination class does only a partial test with the modifier keys. This method is overridden in subclasses to include the main key in the test.
    
    Parameters:
    
    event - the key event
    
    Returns:
    
    true if the key combinations match, false otherwise
  - getName
```
public java.lang.String getName()
```
    Returns a string representation of this KeyCombination.
    The string representation consists of sections separated by plus characters. Each section specifies either a modifier key or the main key.
    A modifier key section contains the KeyCode name of a modifier key. It can be prefixed with the Ignored keyword. A non-prefixed modifier key implies its DOWN value while the prefixed version implies the ANY (ignored) value. If some modifier key is not specified in the string at all, it means it has the default UP value.
    The format of the main key section of the key combination string depends on the KeyCombination subclass. It is either the key code name for KeyCodeCombination or the single quoted key character for KeyCharacterCombination.
    Examples of KeyCombination string representations:
```
"Ctrl+Alt+Q"
"Ignore Shift+Ctrl+A"
"Alt+'w'"
```
    Returns:
    
    the string representation of this KeyCombination
  - getDisplayText
```
public java.lang.String getDisplayText()
```
    Returns a string representation of this KeyCombination that is suitable for display in a user interface (for example, beside a menu item).
    
    Returns:
    
    A string representation of this KeyCombination, suitable for display in a user interface.
    
    Since:
    
    JavaFX 8u20
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Tests whether this KeyCombination equals to the specified object.
    
    Overrides:
    
    equals in class java.lang.Object
    
    Parameters:
    
    obj - the object to compare to
    
    Returns:
    
    true if the objects are equal, false otherwise
  - hashCode
```
public int hashCode()
```
    Returns a hash code value for this KeyCombination.
    
    Overrides:
    
    hashCode in class java.lang.Object
    
    Returns:
    
    the hash code value
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this object. Implementation returns the result of the getName() call.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    the string representation of this KeyCombination
  - valueOf
```
public static KeyCombination valueOf(java.lang.String value)
```
    Constructs a new KeyCombination from the specified string. The string should be in the same format as produced by the getName method.
    If the main key section string is quoted in single quotes the method creates a new KeyCharacterCombination for the unquoted substring. Otherwise it finds the key code which name corresponds to the main key section string and creates a KeyCodeCombination for it. If this can't be done, it falls back to the KeyCharacterCombination.
    
    Parameters:
    
    value - the string which represents the requested key combination
    
    Returns:
    
    the constructed KeyCombination
    
    Since:
    
    JavaFX 2.1
  - keyCombination
```
public static KeyCombination keyCombination(java.lang.String name)
```
    Constructs a new KeyCombination from the specified string. This method simply delegates to valueOf(String).
    
    Parameters:
    
    name - the string which represents the requested key combination
    
    Returns:
    
    the constructed KeyCombination
    
    See Also:
    
    valueOf(String)
  - addModifiersIntoString
```
private void addModifiersIntoString(java.lang.StringBuilder sb)
```
  - addModifierIntoString
```
private static void addModifierIntoString(java.lang.StringBuilder sb,
                                          KeyCode modifierKey,
                                          KeyCombination.ModifierValue modifierValue)
```
  - test
```
private static boolean test(KeyCode testedModifierKey,
                            KeyCombination.ModifierValue testedModifierValue,
                            KeyCode shortcutModifierKey,
                            KeyCombination.ModifierValue shortcutModifierValue,
                            boolean isKeyDown)
```
  - test
```
private static boolean test(KeyCombination.ModifierValue modifierValue,
                            boolean isDown)
```
  - resolveModifierValue
```
private static KeyCombination.ModifierValue resolveModifierValue(KeyCombination.ModifierValue firstValue,
                                                                 KeyCombination.ModifierValue secondValue)
```
  - getModifier
```
static KeyCombination.Modifier getModifier(java.lang.String name)
```
  - getModifierValue
```
private static KeyCombination.ModifierValue getModifierValue(KeyCombination.Modifier[] modifiers,
                                                             KeyCode modifierKey)
```
  - normalizeToken
```
private static java.lang.String normalizeToken(java.lang.String token)
```
  - splitName
```
private static java.lang.String[] splitName(java.lang.String name)
```

Class KeyCombination

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SHIFT_DOWN

SHIFT_ANY

CONTROL_DOWN

CONTROL_ANY

ALT_DOWN

ALT_ANY

META_DOWN

META_ANY

SHORTCUT_DOWN

SHORTCUT_ANY

POSSIBLE_MODIFIERS

NO_MATCH

shift

control

alt

meta

shortcut

Constructor Detail

KeyCombination

KeyCombination

Method Detail

getShift

getControl

getAlt

getMeta

getShortcut

match

getName

getDisplayText

equals

hashCode

toString

valueOf

keyCombination

addModifiersIntoString

addModifierIntoString

test

test

resolveModifierValue

getModifier

getModifierValue

normalizeToken

splitName