Class KeyEvent
- Direct Known Subclasses:
TraverseEvent
,VerifyEvent
When a key listener is added to a control, the control will take part in widget traversal. By default, all traversal keys (such as the tab key and so on) are delivered to the control. In order for a control to take part in traversal, it should listen for traversal events. Otherwise, the user can traverse into a control but not out. Note that native controls such as table and tree implement key traversal in the operating system. It is not necessary to add traversal listeners for these controls, unless you want to override the default traversal.
IMPORTANT: All public static
members of
this class are not part of the RWT public API. They are marked
public only so that they can be shared within the packages provided by RWT.
They should never be accessed from application code.
- Since:
- 1.2
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionchar
the character represented by the key that was typed.boolean
A flag indicating whether the operation should be allowed.int
the key code of the key that was typed, as defined by the key code constants in classSWT
.int
the state of the keyboard modifier keys at the time the event was generated, as defined by the key code constants in classSWT
.Fields inherited from class org.eclipse.swt.events.TypedEvent
data, display, time, widget
-
Constructor Summary
-
Method Summary
-
Field Details
-
character
public char characterthe character represented by the key that was typed. This is the final character that results after all modifiers have been applied. For example, when the user types Ctrl+A, the character value is 0x01. It is important that applications do not attempt to modify the character value based on a stateMask (such as SWT.CTRL) or the resulting character will not be correct. -
keyCode
public int keyCodethe key code of the key that was typed, as defined by the key code constants in classSWT
. When the character field of the event is ambiguous, this field contains the unicode value of the original character. For example, typing Ctrl+M or Return both result in the character '\r' but the keyCode field will also contain '\r' when Return was typed.- See Also:
-
stateMask
public int stateMaskthe state of the keyboard modifier keys at the time the event was generated, as defined by the key code constants in classSWT
.- See Also:
-
doit
public boolean doitA flag indicating whether the operation should be allowed. Setting this field tofalse
will cancel the operation.
-
-
Constructor Details
-
KeyEvent
Constructs a new instance of this class based on the information in the given untyped event.- Parameters:
event
- the untyped event containing the information
-
-
Method Details
-
toString
Returns a string containing a concise, human-readable description of the receiver.- Overrides:
toString
in classTypedEvent
- Returns:
- a string representation of the event
-