summaryrefslogtreecommitdiffstats
path: root/doc/CrtWindow.3
diff options
context:
space:
mode:
authorericm <ericm>2000-10-05 18:31:24 (GMT)
committerericm <ericm>2000-10-05 18:31:24 (GMT)
commit250f34d4aa82b5c5d86b64b06f8d50e532e3ec38 (patch)
tree79fe531fc886831c0e17508f151e45a8bc1e1fed /doc/CrtWindow.3
parent3c249a7000fb9bacdda68774c89048bccb81d87a (diff)
downloadtk-250f34d4aa82b5c5d86b64b06f8d50e532e3ec38.zip
tk-250f34d4aa82b5c5d86b64b06f8d50e532e3ec38.tar.gz
tk-250f34d4aa82b5c5d86b64b06f8d50e532e3ec38.tar.bz2
* generic/tkCmds.c (Tk_WinfoObjCmd): Added check for
TK_ANONYMOUS_WINDOW flag in the [winfo children] subcommand; if set, the window will not be printed in the list of children. * doc/CrtWindow.3: Added entry for Tk_CreateAnonymousWindow. * generic/tkWindow.c (Tk_CreateAnonymousWindow): New API for creating anonymous windows. These windows are manipulable from C, but not from Tcl, because they have no pathname associated with them. They are used initially by widgets that do rubber-band resizing (panedwindow, multi-column listbox, etc.), and may be useful for other widgets as well (dropbox, combobox). (Tk_DestroyWindow): Added check for TK_ANONYMOUS_WINDOW flag when determining whether to generate a DestroyNotify event. * generic/tkStubInit.c: * generic/tkDecls.h: Regen'd from tk.decls. * generic/tk.decls: Added Tk_CreateAnonymousWindow declaration. * generic/tk.h: Added TK_ANONYMOUS_WINDOW flag for Tk_Window's.
Diffstat (limited to 'doc/CrtWindow.3')
-rw-r--r--doc/CrtWindow.315
1 files changed, 12 insertions, 3 deletions
diff --git a/doc/CrtWindow.3 b/doc/CrtWindow.3
index a080e7c..874d76e 100644
--- a/doc/CrtWindow.3
+++ b/doc/CrtWindow.3
@@ -5,7 +5,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: CrtWindow.3,v 1.4 1999/04/21 21:53:21 rjohnson Exp $
+'\" RCS: @(#) $Id: CrtWindow.3,v 1.5 2000/10/05 18:31:24 ericm Exp $
'\"
.so man.macros
.TH Tk_CreateWindow 3 4.2 Tk "Tk Library Procedures"
@@ -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)
@@ -51,9 +54,9 @@ Name of new window, specified as path name within application
.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