tk_setappname(3) [centos man page]

Tk_SetAppName(3)					       Tk Library Procedures						  Tk_SetAppName(3)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_SetAppName - Set the name of an application for 'send' commands

SYNOPSIS

       #include <tk.h>

       const char *
       Tk_SetAppName(tkwin, name)

ARGUMENTS

       Tk_Window tkwin (in)	      Token for window in application.	Used only to select a particular application.

       const char *name (in)	      Name under which to register the application.
_________________________________________________________________

DESCRIPTION

       Tk_SetAppName associates a name with a given application and records that association on the display containing with the application's main
       window.	After this procedure has been invoked, other applications on the display will be able to use the send command to invoke operations
       in  the	application.  If name is already in use by some other application on the display, then a new name will be generated by appending "
       #2" to name;  if this name is also in use, the number will be incremented until an unused name is found.  The return value from the  proce-
       dure is a pointer to the name actually used.

       If the application already has a name when Tk_SetAppName is called, then the new name replaces the old name.

       Tk_SetAppName also adds a send command to the application's interpreter, which can be used to send commands from this application to others
       on any of the displays where the application has windows.

       The application's name registration persists until the interpreter is deleted or the send command is deleted from interp,  at  which  point
       the  name is automatically unregistered and the application becomes inaccessible via send.  The application can be made accessible again by
       calling Tk_SetAppName.

       Tk_SetAppName is called automatically by Tk_Init, so applications do not normally need to call it explicitly.

       The command tk appname provides Tcl-level access to the functionality of Tk_SetAppName.

KEYWORDS

       application, name, register, send command

Tk									4.0							  Tk_SetAppName(3)

Tk_Init(3)						       Tk Library Procedures							Tk_Init(3)

__________________________________________________________________________________________________________________________________________________

NAME

       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 initializa-
       tion  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 commands 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 contents	of
	      the clipboard are pasted.

       grab   Grab can be used to block the user from using any other applications.

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

       selection
	      See clipboard.

       send   Send can be used to cause unsafe interpreters to execute commands.

       tk     The tk command recreates the send command, which is unsafe.

       tkwait Tkwait can block the containing process forever

       toplevel
	      Toplevels can be used to cover the entire screen and to steal input from the user.

       wm     If toplevels are ever allowed, wm can be used to remove decorations, move windows around, etc.

KEYWORDS

       safe, application, initialization, load, main window

Tk									8.0								Tk_Init(3)