Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tkwait (1t)

Name

tkwait - Wait for variable to change or window to be destroyed

Synopsis

tkwait variable name

tkwait visibility name

tkwait window name

Description

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



______________________________________________________________________________

NAME
       tkwait - Wait for variable to change or window to be destroyed

SYNOPSIS
       tkwait variable name

       tkwait visibility name

       tkwait window name
______________________________________________________________________________

DESCRIPTION
       The  tkwait  command waits for one of several things to happen, then it
       returns without taking any other actions.  The return value  is  always
       an  empty  string.  If the first argument is variable (or any abbrevia-
       tion of it) then the second argument is the name of a  global  variable
       and  the  command waits for that variable to be modified.  If the first
       argument is visibility (or any abbreviation  of  it)  then  the  second
       argument  is  the  name  of a window and the tkwait command waits for a
       change in its visibility state (as indicated by the arrival of a  Visi-
       bilityNotify  event).  This form is typically used to wait for a newly-
       created window to appear on the screen before taking some  action.   If
       the  first argument is window (or any abbreviation of it) then the sec-
       ond argument is the name of a window and the tkwait command  waits  for
       that window to be destroyed.  This form is typically used to wait for a
       user to finish interacting with a dialog box before using the result of
       that interaction.

       While  the  tkwait command is waiting it processes events in the normal
       fashion, so the application will continue to respond to  user  interac-
       tions.   If  an  event handler invokes tkwait again, the nested call to
       tkwait must complete before the outer call can complete.


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       bind(n), vwait(n)

KEYWORDS
       variable, visibility, wait, window



NOTES
       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                                                                  tkwait(1t)