diff options
author | William Joye <wjoye@cfa.harvard.edu> | 2016-12-21 22:13:18 (GMT) |
---|---|---|
committer | William Joye <wjoye@cfa.harvard.edu> | 2016-12-21 22:13:18 (GMT) |
commit | 07e464099b99459d0a37757771791598ef3395d9 (patch) | |
tree | 4ba7d8aad13735e52f59bdce7ca5ba3151ebd7e3 /tk8.6/doc/SetAppName.3 | |
parent | deb3650e37f26f651f280e480c4df3d7dde87bae (diff) | |
download | blt-07e464099b99459d0a37757771791598ef3395d9.zip blt-07e464099b99459d0a37757771791598ef3395d9.tar.gz blt-07e464099b99459d0a37757771791598ef3395d9.tar.bz2 |
new subtree for tcl/tk
Diffstat (limited to 'tk8.6/doc/SetAppName.3')
-rw-r--r-- | tk8.6/doc/SetAppName.3 | 62 |
1 files changed, 0 insertions, 62 deletions
diff --git a/tk8.6/doc/SetAppName.3 b/tk8.6/doc/SetAppName.3 deleted file mode 100644 index 3978850..0000000 --- a/tk8.6/doc/SetAppName.3 +++ /dev/null @@ -1,62 +0,0 @@ -'\" -'\" Copyright (c) 1994 The Regents of the University of California. -'\" Copyright (c) 1994-1997 Sun Microsystems, Inc. -'\" -'\" See the file "license.terms" for information on usage and redistribution -'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. -'\" -.TH Tk_SetAppName 3 4.0 Tk "Tk Library Procedures" -.so man.macros -.BS -.SH NAME -Tk_SetAppName \- Set the name of an application for 'send' commands -.SH SYNOPSIS -.nf -\fB#include <tk.h>\fR -.sp -const char * -\fBTk_SetAppName\fR(\fItkwin, name\fR) -.SH ARGUMENTS -.AS Tk_Window parent -.AP Tk_Window tkwin in -Token for window in application. Used only to select a particular -application. -.AP "const char" *name in -Name under which to register the application. -.BE -.SH DESCRIPTION -.PP -\fBTk_SetAppName\fR 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 \fBsend\fR command to invoke operations -in the application. -If \fIname\fR is already in use by some other application on the -display, then a new name will be generated by appending -.QW "\fB #2\fR" -to \fIname\fR; 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. -.PP -If the application already has a name when \fBTk_SetAppName\fR is -called, then the new name replaces the old name. -.PP -\fBTk_SetAppName\fR also adds a \fBsend\fR 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. -.PP -The application's name registration persists until the interpreter is -deleted or the \fBsend\fR command is deleted from \fIinterp\fR, at which -point the name is automatically unregistered and the application -becomes inaccessible via \fBsend\fR. -The application can be made accessible again by calling \fBTk_SetAppName\fR. -.PP -\fBTk_SetAppName\fR is called automatically by \fBTk_Init\fR, -so applications do not normally need to call it explicitly. -.PP -The command \fBtk appname\fR provides Tcl-level access to the -functionality of \fBTk_SetAppName\fR. -.SH KEYWORDS -application, name, register, send command |