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 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 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)