tkwait(n)		     Ck Built-In Commands		     tkwait(n)



______________________________________________________________________________

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. This form is typically used to wait for
       a  newly-created	 window	 to  appear  on	 the screen before taking some
       action.	At the time of this  writing,  visibility  state  changes  are
       unreliable.   Thus this form of the tkwait command is strongly discour-
       aged.  If the first argument is window (or any abbreviation of it) then
       the  second  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.


KEYWORDS
       variable, visibility, wait, window



Ck				      8.0			     tkwait(n)
