ASPN ActiveState Programmer Network
  ActiveState
/ Home / Perl / PHP / Python / Tcl / XSLT /
/ Safari / My ASPN /
Cookbooks | Documentation | Mailing Lists | Modules | News Feeds | Products | User Groups | Web Services
SEARCH

Reference
ActiveTcl
ActiveTcl 8.4.19.1 User Guide
ActiveTcl 8.4.19.1 Documentation Index
Tk Manual
Tk built-in commands
General
console
destroy
tk
tkerror
tkvars
tkwait
winfo
wish
wm

MyASPN >> Reference >> ActiveTcl >> ActiveTcl 8.4.19.1 User Guide >> ActiveTcl 8.4.19.1 Documentation Index >> Tk Manual >> Tk built-in commands >> General

Tcl/Tk Documentation > TkCmd > tkwait

Tcl/Tk Applications | Tcl Commands | Tk Commands | Tcl Library | Tk Library

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 abbreviation 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 VisibilityNotify 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 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 interactions. If an event handler invokes tkwait again, the nested call to tkwait must complete before the outer call can complete.

KEYWORDS

variable, visibility, wait, window
Copyright © 1995-1997 Roger E. Critchlow Jr. Copyright © 1992 The Regents of the University of California. Copyright © 1994-1996 Sun Microsystems, Inc.

Privacy Policy | Email Opt-out | Feedback | Syndication
© ActiveState 2004 All rights reserved