Class KeyStroke
- All Implemented Interfaces:
Comparable
A KeyStroke is defined as an optional set of modifier keys
followed optionally by a natural key. A KeyStroke is said to
be complete if it contains a natural key. A natural key is any Unicode
character (e.g., "backspace", etc.), any character belonging to a natural
language (e.g., "A", "1", "[", etc.), or any special control character
specific to computers (e.g., "F10", "PageUp", etc.).
All KeyStroke objects have a formal string representation
available via the toString() method. There are a number of
methods to get instances of KeyStroke objects, including one
which can parse this formal string representation.
All KeyStroke objects, via the format() method,
provide a version of their formal string representation translated by
platform and locale, suitable for display to a user.
KeyStroke objects are immutable. Clients are not permitted to
extend this class.
- Since:
- 3.1
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringThe delimiter between multiple keys in a single key strokes -- expressed in the formal key stroke grammar.static final StringThe set of delimiters forKeyobjects allowed during parsing of the formal string representation.static final intThe representation for no key. -
Method Summary
Modifier and TypeMethodDescriptionfinal intfinal booleanTests whether this object is equal to another object.final Stringformat()Formats this key stroke into the current default look.static final KeyStrokegetInstance(int naturalKey) Creates an instance ofKeyStrokegiven a natural key.static final KeyStrokegetInstance(int modifierKeys, int naturalKey) Creates an instance ofKeyStrokegiven a set of modifier keys and a natural key.static final KeyStrokegetInstance(String string) Creates an instance ofKeyStrokeby parsing a given a formal string representation.final intReturns the modifier keys for this key stroke.final intReturns the natural key for this key stroke.final inthashCode()Computes the hash code for this object.final booleanReturns whether or not this key stroke is complete.final StringtoString()Returns the formal string representation for this key stroke.
-
Field Details
-
KEY_DELIMITER
The delimiter between multiple keys in a single key strokes -- expressed in the formal key stroke grammar. This is not to be displayed to the user. It is only intended as an internal representation.- See Also:
-
KEY_DELIMITERS
The set of delimiters forKeyobjects allowed during parsing of the formal string representation.- See Also:
-
NO_KEY
public static final int NO_KEYThe representation for no key.- See Also:
-
-
Method Details
-
getInstance
Creates an instance ofKeyStrokegiven a natural key.- Parameters:
naturalKey- the natural key. The format of this integer is defined by whichever widget toolkit you are using;NO_KEYalways means no natural key.- Returns:
- a key stroke. This key stroke will have no modifier keys.
Guaranteed not to be
null. - See Also:
-
getInstance
Creates an instance ofKeyStrokegiven a set of modifier keys and a natural key.- Parameters:
modifierKeys- the modifier keys. The format of this integer is defined by whichever widget toolkit you are using;NO_KEYalways means no modifier keys.naturalKey- the natural key. The format of this integer is defined by whichever widget toolkit you are using;NO_KEYalways means no natural key.- Returns:
- a key stroke. Guaranteed not to be
null. - See Also:
-
getInstance
Creates an instance ofKeyStrokeby parsing a given a formal string representation.- Parameters:
string- the formal string representation to parse.- Returns:
- a key stroke. Guaranteed not to be
null. - Throws:
ParseException- if the given formal string representation could not be parsed to a valid key stroke.
-
compareTo
-
equals
Description copied from class:TriggerTests whether this object is equal to another object. A handle object is only equal to another trigger with the same properties. -
format
Formats this key stroke into the current default look.- Returns:
- A string representation for this key stroke using the default
look; never
null.
-
getModifierKeys
public final int getModifierKeys()Returns the modifier keys for this key stroke.- Returns:
- the bit mask of modifier keys;
NO_KEYmeans that there is no modifier key.
-
getNaturalKey
public final int getNaturalKey()Returns the natural key for this key stroke.- Returns:
- The natural key for this key stroke. This value is
NO_KEYif the key stroke is incomplete (i.e., has no natural key).
-
hashCode
public final int hashCode()Description copied from class:TriggerComputes the hash code for this object. -
isComplete
public final boolean isComplete()Returns whether or not this key stroke is complete. Key strokes are complete iff they have a natural key which is notNO_KEY.- Returns:
true, iff the key stroke is complete.
-
toString
Returns the formal string representation for this key stroke.
-