This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

Tk_Main(3)                                  Tk Library Procedures                                 Tk_Main(3)



____________________________________________________________________________________________________________

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 proce-dure. procedure.
                                                  dure.  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(3)