Tk_SetAppName(3)

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  applica-
                                    tion.   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  applica-
     tion.   If  name is already in use by some other application
     on the display, then a new name will be generated by append-
     ing  " #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  unre-
     gistered  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  appli-
     cations do not normally need to call it explicitly.

Tk                      Last change: 4.0                        1

Tk_SetAppName(3)      Tk Library Procedures      Tk_SetAppName(3)

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

KEYWORDS

     application, name, register, send command

Tk                      Last change: 4.0                        2