tk_focusNext(n) Tk Built-In Commands tk_focusNext(n)_________________________________________________________________NAME
tk_focusNext, tk_focusPrev, tk_focusFollowsMouse - Utility
procedures for managing the input focus.
SYNOPSIS
tk_focusNext window
tk_focusPrev window
tk_focusFollowsMouse
_________________________________________________________________DESCRIPTION
tk_focusNext is a utility procedure used for keyboard
traversal. It returns the ``next'' window after window in
focus order. The focus order is determined by the stack-
ing order of windows and the structure of the window hier-
archy. Among siblings, the focus order is the same as the
stacking order, with the lowest window being first. If a
window has children, the window is visited first, followed
by its children (recursively), followed by its next sib-
ling. Top-level windows other than window are skipped, so
that tk_focusNext never returns a window in a different
top-level from window.
After computing the next window, tk_focusNext examines the
window's -takefocus option to see whether it should be
skipped. If so, tk_focusNext continues on to the next
window in the focus order, until it eventually finds a
window that will accept the focus or returns back to win-
dow.
tk_focusPrev is similar to tk_focusNext except that it
returns the window just before window in the focus order.
tk_focusFollowsMouse changes the focus model for the
application to an implicit one where the window under the
mouse gets the focus. After this procedure is called,
whenever the mouse enters a window Tk will automatically
give it the input focus. The focus command may be used to
move the focus to a window other than the one under the
mouse, but as soon as the mouse moves into a new window
the focus will jump to that window. Note: at present
there is no built-in support for returning the application
to an explicit focus model; to do this you'll have to
write a script that deletes the bindings created by
tk_focusFollowsMouse.
KEYWORDS
focus, keyboard traversal, top-level
Tk 4.0 1
