Tk Built-In Commands                             tkfocusNext(1T)





NAME
     tkfocusNext, tkfocusPrev, tkfocusFollowsMouse  -  Utility
     procedures for managing the input focus.

SYNOPSIS
     tkfocusNext window

     tkfocusPrev window

     tkfocusFollowsMouse



DESCRIPTION
     tkfocusNext  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  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 chil-
     dren (recursively), followed by its next sibling.  Top-level
     windows other than window are skipped, so that  tkfocusNext
     never returns a window in a different top-level from window.

     After computing the next window, tkfocusNext  examines  the
     window's  -takefocus  option  to  see  whether  it should be
     skipped.  If so, tkfocusNext continues on to the next  win-
     dow  in  the focus order, until it eventually finds a window
     that will accept the focus or returns back to window.

     tkfocusPrev is  similar  to  tkfocusNext  except  that  it
     returns the window just before window in the focus order.

     tkfocusFollowsMouse changes the focus model for the  appli-
     cation  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 tkfocusFollowsMouse.


KEYWORDS
     focus, keyboard traversal, top-level




Tk                      Last change: 4.0                        1






Tk Built-In Commands                             tkfocusNext(1T)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWTk         
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for Tk is available on http:/opensolaris.org.









































Tk                      Last change: 4.0                        2