This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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 applica-tions applications
       tions 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_SetApp-Name. Tk_SetAppName.
       Name.

       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



Tk                                                   4.0                                    Tk_SetAppName(3)