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:

• Some function keys (f1, f3, f5, etc) which trigger native browser behavior. [These can be suppressed in Internet Explorer and Mozilla Firefox but not in some other browsers such as Safari / Chrome, etc]
• Some accelerator key combos such as Alt+f3
• The "Meta" key (the Windows / Apple key to show OS level menu)

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()