Tk_Init,  Tk_SafeInit  -  add  Tk  to  an interpreter and make a new Tk
       application.

SYNOPSIS

       #include <tk.h>

       int
       Tk_Init(interp)

       int
       Tk_SafeInit(interp)

ARGUMENTS

       Tcl_Interp   *interp            (in)      Interpreter in which to  load
                                                 Tk.  Tk should not already be
                                                 loaded in this interpreter.
_________________________________________________________________

DESCRIPTION

       Tk_Init is the package initialization procedure for Tk.  It is normally
       invoked  by the Tcl_AppInit procedure for an application or by the load
       command.  Tk_Init adds all of Tk's commands to interp and creates a new
       Tk  application,  including  its main window.  If the initialization is
       successful Tk_Init returns TCL_OK;  if there is  an  error  it  returns
       TCL_ERROR.    Tk_Init   also  leaves  a  result  or  error  message  in
       interp->result.

       If there is a variable argv in interp, Tk_Init treats the  contents  of
       this  variable  as  a  list of options for the new Tk application.  The
       options may have any of the forms documented for the  wish  application
       (in fact, wish uses Tk_Init to process its command-line arguments).

       Tk_SafeInit  is identical to Tk_Init except that it removes all Tk com-
       mands that are considered unsafe.  Those commands and the  reasons  for
       their exclusion are:

       bell   Continuous ringing of the bell is a nuisance.

       clipboard
              A  malicious  script could replace the contents of the clipboard
              with the string "rm -r *" and lead to surprises  when  the  con-
              tents of the clipboard are pasted.

       grab   Grab can be used to block the user from using any other applica-
              tions.

       menu   Menus can be used to cover the entire screen and to steal  input
              from the user.

       selection
              See clipboard.

KEYWORDS

       safe, application, initialization, load, main window



Tk                                    8.0                           Tk_Init(3)