diff options
Diffstat (limited to 'tk/doc/CrtWindow.3')
-rw-r--r-- | tk/doc/CrtWindow.3 | 20 |
1 files changed, 14 insertions, 6 deletions
diff --git a/tk/doc/CrtWindow.3 b/tk/doc/CrtWindow.3 index 4f477057618..2e7ff4d72b7 100644 --- a/tk/doc/CrtWindow.3 +++ b/tk/doc/CrtWindow.3 @@ -20,6 +20,9 @@ Tk_Window \fBTk_CreateWindow\fR(\fIinterp, parent, name, topLevScreen\fR) .sp Tk_Window +\fBTk_CreateAnonymousWindow\fR(\fIinterp, parent, topLevScreen\fR) +.sp +Tk_Window \fBTk_CreateWindowFromPath\fR(\fIinterp, tkwin, pathName, topLevScreen\fR) .sp \fBTk_DestroyWindow\fR(\fItkwin\fR) @@ -33,10 +36,10 @@ then \fI*interp\fR isn't modified. .AP Tk_Window parent in Token for the window that is to serve as the logical parent of the new window. -.AP char *name in +.AP "CONST char" *name in Name to use for this window. Must be unique among all children of the same \fIparent\fR. -.AP char *topLevScreen in +.AP "CONST char" *topLevScreen in Has same format as \fIscreenName\fR. If NULL, then new window is created as an internal window. If non-NULL, new window is created as a top-level window on screen \fItopLevScreen\fR. If \fItopLevScreen\fR @@ -44,16 +47,16 @@ is an empty string (``'') then new window is created as top-level window of \fIparent\fR's screen. .AP Tk_Window tkwin in Token for window. -.AP char *pathName in +.AP "CONST char" *pathName in Name of new window, specified as path name within application (e.g. \fB.a.b.c\fR). .BE .SH DESCRIPTION .PP -The procedures \fBTk_CreateWindow\fR +The procedures \fBTk_CreateWindow\fR, .VS -and \fBTk_CreateWindowFromPath\fR +\fBTk_CreateAnonymousWindow\fR, and \fBTk_CreateWindowFromPath\fR are used to create new windows for use in Tk-based applications. Each of the procedures returns a token that can be used to manipulate the window in other calls to the Tk @@ -86,6 +89,12 @@ menu's \fIparent\fR would be the button-like window used to invoke it, which would in turn be a child of the menu bar window. A dialog box might have the application's main window as its parent. .PP +\fBTk_CreateAnonymousWindow\fR differs from \fBTk_CreateWindow\fR in +that it creates an unnamed window. This window will be manipulable +only using C interfaces, and will not be visible to Tcl scripts. Both +interior windows and top-level windows may be created with +\fBTk_CreateAnonymousWindow\fR. +.PP \fBTk_CreateWindowFromPath\fR offers an alternate way of specifying new windows. In \fBTk_CreateWindowFromPath\fR the new window is specified with a token for any window in the target @@ -140,4 +149,3 @@ the X commands to instantiate the window given by \fItkwin\fR. .SH KEYWORDS create, deferred creation, destroy, display, internal window, screen, top-level window, window - |