Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022

bindtags (1t)


bindtags - Determine which bindings apply to a window, and order of evaluation


bindtags window ?tagList?


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


       bindtags  -  Determine  which  bindings apply to a window, and order of

       bindtags window ?tagList?

       When a binding is created with  the  bind  command,  it  is  associated
       either  with  a  particular window such as .a.b.c, a class name such as
       Button, the keyword all, or any other string.  All of these  forms  are
       called  binding tags.  Each window contains a list of binding tags that
       determine how events are processed  for  the  window.   When  an  event
       occurs  in  a  window,  it  is  applied to each of the window's tags in
       order:  for each tag, the most specific binding that matches the  given
       tag  and  event is executed.  See the bind command for more information
       on the matching process.

       By default, each window has four binding tags consisting of the name of
       the  window,  the window's class name, the name of the window's nearest
       toplevel ancestor, and all, in that order.  Toplevel windows have  only
       three  tags  by default, since the toplevel name is the same as that of
       the window.  The bindtags command allows the binding tags for a  window
       to be read and modified.

       If  bindtags is invoked with only one argument, then the current set of
       binding tags for window is returned as a list.  If the tagList argument
       is  specified  to bindtags, then it must be a proper list; the tags for
       window are changed to the  elements  of  the  list.   The  elements  of
       tagList may be arbitrary strings;  however, any tag starting with a dot
       is treated as the name of a window;  if no window by that  name  exists
       at  the  time  an  event is processed, then the tag is ignored for that
       event.  The order of the elements in tagList determines  the  order  in
       which binding scripts are executed in response to events.  For example,
       the command
              bindtags .b {all . Button .b}
       reverses the order in which binding scripts will  be  evaluated  for  a
       button  named  .b  so that all bindings are invoked first, following by
       bindings for .b's toplevel ("."), followed by class bindings,  followed
       by  bindings for .b.  If tagList is an empty list then the binding tags
       for window are returned to the default state described above.

       The bindtags command may be  used  to  introduce  arbitrary  additional
       binding  tags  for  a window, or to remove standard tags.  For example,
       the command
              bindtags .b {.b TrickyButton . all}
       replaces the Button tag for .b with TrickyButton.  This means that  the
       default widget bindings for buttons, which are associated with the But-
       ton tag, will no longer apply to .b, but any bindings  associated  with
       TrickyButton (perhaps some new button behavior) will apply.

       If you have a set of nested frame widgets and you want events sent to a
       button widget to also be delivered to all the widgets up to the current
       toplevel  (in  contrast  to Tk's default behavior, where events are not
       delivered to those intermediate windows) to  make  it  easier  to  have
       accelerators that are only active for part of a window, you could use a
       helper procedure like this to help set things up:
              proc setupBindtagsForTreeDelivery {widget} {
                  set tags [list $widget [winfo class $widget]]
                  set w $widget
                  set t [winfo toplevel $w]
                  while {$w ne $t} {
                      set w [winfo parent $w]
                      lappend tags $w
                  lappend tags all
                  bindtags $widget $tags

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

       |Availability   | runtime/tk-8     |
       |Stability      | Uncommitted      |


       binding, event, tag

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

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded        from         https://source-

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

Tk                                    4.0                         bindtags(1t)