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

1mSYNOPSIS0m
       1mtkwait variable 4m22mname0m

       1mtkwait visibility 4m22mname0m

       1mtkwait window 4m22mname0m


1mDESCRIPTION0m
       The  1mtkwait  22mcommand 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 1mvariable 22m(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 1mvisibility 22m(or any abbreviation  of  it)  then  the  second
       argument  is  the  name  of a window and the 1mtkwait 22mcommand 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 1mwindow 22m(or any abbreviation of it) then the sec-
       ond argument is the name of a window and the 1mtkwait 22mcommand  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  1mtkwait 22mcommand 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 1mtkwait 22magain, the nested call to
       1mtkwait 22mmust complete before the outer call can complete.


1mKEYWORDS0m
