Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

tk_focusNext (1t)

Name

tk_focusNext - Utility procedures for managing the input focus.

Synopsis

tk_focusNext window

tk_focusPrev window

tk_focusFollowsMouse

Description

tk_focusNext(1t)             Tk Built-In Commands             tk_focusNext(1t)



______________________________________________________________________________

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 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 (recur-
       sively), followed by its next sibling.  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 window.

       tk_focusPrev is similar to tk_focusNext except that it returns the win-
       dow 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 return-
       ing the application to an explicit focus model;  to do  this  you  will
       have  to  write a script that deletes the bindings created by tk_focus-
       FollowsMouse.

KEYWORDS
       focus, keyboard traversal, top-level



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                    4.0                     tk_focusNext(1t)