1mNAME0m
       tk_focusNext,  tk_focusPrev,  tk_focusFollowsMouse - Utility procedures
       for managing the input focus.

1mSYNOPSIS0m
       1mtk_focusNext 4m22mwindow0m

       1mtk_focusPrev 4m22mwindow0m

       1mtk_focusFollowsMouse0m


1mDESCRIPTION0m
       1mtk_focusNext 22mis a utility procedure used for  keyboard  traversal.   It
       returns  the  ``next''  window  after 4mwindow24m in focus order.  The focus
       order is determined by the stacking order of windows and the  structure
       of  the  window hierarchy.  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 sibling.  Top-level  windows  other
       than 4mwindow24m are skipped, so that 1mtk_focusNext 22mnever returns a window in
       a different top-level from 4mwindow24m.

       After computing the next window,  1mtk_focusNext  22mexamines  the  window's
       1m-takefocus  22moption  to  see  whether  it  should  be  skipped.   If so,
       1mtk_focusNext 22mcontinues on to the next window in the focus order,  until
       it eventually finds a window that will accept the focus or returns back
       to 4mwindow24m.

       1mtk_focusPrev 22mis similar to 1mtk_focusNext 22mexcept that it returns the win-
       dow just before 4mwindow24m in the focus order.

       1mtk_focusFollowsMouse  22mchanges 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 1mfocus 22mcommand 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 return-
       ing the application to an explicit focus model;  to do this you'll have
       to write a script that deletes the bindings created by 1mtk_focusFollows-0m
       1mMouse22m.


1mKEYWORDS0m
