com.smartgwt.client.docs
Interface KeyboardEvents


public interface KeyboardEvents

Keyboard Events

Smart GWT allows keyboard events to be captured at the page level via Page.registerKey or Page.setEvent or at the widget level via Canvas.keyDown, Canvas.keyPress, and Canvas.keyUp.

Details about the key events can be retrieved via static methods on the EventHandler class including EventHandler.getKey, EventHandler.getKeyEventCharacter and EventHandler.getKeyEventCharacterValue.

As with other Smart GWT event handling code, returning false will suppress the default native browser behavior.
Note: browsers do not allow cancellation of some keys' default behaviors. These cases vary by browser, and wherever native cancellation is supported, returning false from your event handler should be sufficient to suppress the behavior.
Some specific cases where default behavior cancellation is not always possible include:

If you do want to include functionality for these keys in your application, we'd recommend testing against your expected users' browser types. It is also worth considering whether by changing the functionality of these standard browser keys you may provide an unexpected user experience (for example a user may press "f5" in an attempt to reload the application and be surprised by this triggering some alternative functionality in your application).

See Also:
EventHandler.getKeyEventCharacterValue(), EventHandler.getKeyEventCharacter(), EventHandler.getKey(), EventHandler.shiftKeyDown(), EventHandler.ctrlKeyDown(), EventHandler.altKeyDown()