This is not necessarily the current version of this TIP.This is not necessarily the current version of this TIP.
| TIP: | 204 |
| Title: | Virtual events for keyboard traversal |
| Version: | $Revision: 1.1 $ |
| Author: | Joe English <jenglish at users dot sourceforge dot net> |
| State: | Draft |
| Type: | Project |
| Tcl-Version: | 8.5 |
| Vote: | Pending |
| Created: | Monday, 21 June 2004 |
Proposes using two new virtual events, <<TraverseIn>> and <<TraverseOut>>, to notify widgets of keyboard navigation events.
Certain widgets need to perform some action when they receive and/or lose keyboard focus because of keyboard traversal. For example, tabbing into an Entry or Spinbox widget selects the widget contents.
This cannot be done with a <FocusIn> binding, since widgets may receive <FocusIn> events for reasons other than keyboard traversal.
Tk currently implements this feature with special-case logic that checks the target window's widget class in the tk::TabToWindow procedure. The drawback to this approach is that it only works for the built-in widgets; third party widget sets like BWidget[1], IWidgets[2], and Tile[3] must implement their own workarounds.
Change the standard Tk bindings for <Key-Tab> and <Shift-Key-Tab> to do the following:
Send a <<TraverseOut>> virtual event to the current focus window, if any;
Set the focus to the new window;
Send a <<TraverseIn>> virtual event to the new window.
Additionally, move the current code to handle traversal to Entry and Spinbox widgets from tk::TabToWindow to class bindings.
See Tk Patch #976928[4].
The BWidget package has used an identical scheme since version 1.7; see Tcllib bug #720032[5] for details.
This document has been placed in the public domain.
This is not necessarily the current version of this TIP.