tk/doc/MainLoop.3

   1 '\"
   2 '\" Copyright (c) 1990-1992 The Regents of the University of California.
   3 '\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
   4 '\"
   5 '\" See the file "license.terms" for information on usage and redistribution
   6 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
   7 '\"
   8 '\" RCS: @(#) $Id$
   9 '\"
  10 .so man.macros
  11 .TH Tk_MainLoop 3 "" Tk "Tk Library Procedures"
  12 .BS
  13 .SH NAME
  14 Tk_MainLoop \- loop for events until all windows are deleted
  15 .SH SYNOPSIS
  16 .nf
  17 \fB#include <tk.h>\fR
  18 .sp
  19 \fBTk_MainLoop\fR()
  20 .BE
  21
  22 .SH DESCRIPTION
  23 .PP
  24 \fBTk_MainLoop\fR is a procedure that loops repeatedly calling
  25 \fBTcl_DoOneEvent\fR.  It returns only when there are no applications
  26 left in this process (i.e. no main windows exist anymore).  Most
  27 windowing applications will call \fBTk_MainLoop\fR after
  28 initialization; the main execution of the application will consist
  29 entirely of callbacks invoked via \fBTcl_DoOneEvent\fR.
  30
  31 .SH KEYWORDS
  32 application, event, main loop