NAME

       Tk_Main - main program for Tk-based applications

SYNOPSIS

       #include <tk.h>

       Tk_Main(argc, argv, appInitProc)

ARGUMENTS

       int argc (in)                              Number of elements in argv.

       char *argv[] (in)                          Array of strings containing command-line arguments.

       Tcl_AppInitProc *appInitProc (in)          Address  of  an application-specific initialization procedure.
                                                  The value for this argument is usually Tcl_AppInit.
________________________________________________________________________________________________________________

DESCRIPTION

       Tk_Main acts as the main program for most Tk-based applications.  Starting with Tk 4.0 it is  not  called
       main anymore because it is part of the Tk library and having a function main in a library (particularly a
       shared  library)  causes problems on many systems.  Having main in the Tk library would also make it hard
       to use Tk in C++ programs, since C++ programs must have special C++ main functions.

       Normally each application contains a small main function that does nothing but invoke  Tk_Main.   Tk_Main
       then does all the work of creating and running a wish-like application.

       When  it  is  has  finished  its  own initialization, but before it processes commands, Tk_Main calls the
       procedure given by the appInitProc argument.  This procedure provides a “hook”  for  the  application  to
       perform  its own initialization, such as defining application-specific commands.  The procedure must have
       an interface that matches the type Tcl_AppInitProc:
              typedef int Tcl_AppInitProc(Tcl_Interp *interp);
       AppInitProc is almost always a pointer to Tcl_AppInit; for  more  details  on  this  procedure,  see  the
       documentation for Tcl_AppInit.

KEYWORDS

       application-specific initialization, command-line arguments, main program

Tk                                                     4.0                                          Tk_Main(3tk)