Tk_SetAppName(3) Tk (4.0) Tk_SetAppName(3)
_________________________________________________________________
NAME
Tk_SetAppName - Set the name of an application for ``send''
commands
SYNOPSIS
#include <tk.h>
char *
Tk_SetAppName(tkwin, name)
ARGUMENTS
Tk_Window tkwin (in) Token for window in
application. Used only to
select a particular
application.
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
Page 1 (printed 2/26/99)
Tk_SetAppName(3) Tk (4.0) Tk_SetAppName(3)
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
Page 2 (printed 2/26/99)
