Provided by: tk8.4-doc_8.4.19-4_all bug

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 procedure 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 don't 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