About Us Documentation

Contact Site Map




Tk_SetAppName(3)      Tk Library Procedures                   4.0



Tk_SetAppName - Set the name of an application for ``send'' commands


#include <tk.h> char * Tk_SetAppName(tkwin, name)


Tk_Window tkwin (in) Token for window in applica- tion. Used only to select a particular application. char *name (in) Name under which to register the application. _________________________________________________________________


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 don't normally need to call it explicitly. Tk 1 Tk_SetAppName(3) Tk Library Procedures 4.0 The command tk appname provides Tcl-level access to the functionality of Tk_SetAppName.


application, name, register, send command Tk 2 Prepared by Ready-to-Run Software, Inc.


Email addresses listed on this site may  NOT be used for unsolicited commercial email.

Ready-to-Run Software, Inc Privacy Statement

Portions (c)Copyright, 1996-2005 by Ready-to-Run Software, Inc
(All rights reserved.)
212 Cedar Cove
Lansing, NY 14882
Phone: 607 533 UNIX (8649)
Fax: 607 533 4002

To return to the Ready-to-Run Software WinPak Table of contents please presshere