diff options
Diffstat (limited to 'tk8.6/doc/ManageGeom.3')
-rw-r--r-- | tk8.6/doc/ManageGeom.3 | 90 |
1 files changed, 0 insertions, 90 deletions
diff --git a/tk8.6/doc/ManageGeom.3 b/tk8.6/doc/ManageGeom.3 deleted file mode 100644 index 520546f..0000000 --- a/tk8.6/doc/ManageGeom.3 +++ /dev/null @@ -1,90 +0,0 @@ -'\" -'\" Copyright (c) 1990-1994 The Regents of the University of California. -'\" Copyright (c) 1994-1996 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_ManageGeometry 3 4.0 Tk "Tk Library Procedures" -.so man.macros -.BS -.SH NAME -Tk_ManageGeometry \- arrange to handle geometry requests for a window -.SH SYNOPSIS -.nf -\fB#include <tk.h>\fR -.sp -\fBTk_ManageGeometry\fR(\fItkwin, mgrPtr, clientData\fR) -.SH ARGUMENTS -.AS Tk_GeometryProc clientData -.AP Tk_Window tkwin in -Token for window to be managed. -.AP "const Tk_GeomMgr" *mgrPtr in -Pointer to data structure containing information about the -geometry manager, or NULL to indicate that \fItkwin\fR's geometry -should not be managed anymore. -The data structure pointed to by \fImgrPtr\fR must be static: -Tk keeps a reference to it as long as the window is managed. -.AP ClientData clientData in -Arbitrary one-word value to pass to geometry manager callbacks. -.BE -.SH DESCRIPTION -.PP -\fBTk_ManageGeometry\fR arranges for a particular geometry manager, -described by the \fImgrPtr\fR argument, to control the geometry -of a particular slave window, given by \fItkwin\fR. -If \fItkwin\fR was previously managed by some other geometry manager, -the previous manager loses control in favor of the new one. -If \fImgrPtr\fR is NULL, geometry management is cancelled for -\fItkwin\fR. -.PP -The structure pointed to by \fImgrPtr\fR contains information about -the geometry manager: -.CS -typedef struct { - const char *\fIname\fR; - Tk_GeomRequestProc *\fIrequestProc\fR; - Tk_GeomLostSlaveProc *\fIlostSlaveProc\fR; -} \fBTk_GeomMgr\fR; -.CE -The \fIname\fR field is the textual name for the geometry manager, -such as \fBpack\fR or \fBplace\fR; this value will be returned -by the command \fBwinfo manager\fR. -.PP -\fIrequestProc\fR is a procedure in the geometry manager that -will be invoked whenever \fBTk_GeometryRequest\fR is called by the -slave to change its desired geometry. -\fIrequestProc\fR should have arguments and results that match the -type \fBTk_GeomRequestProc\fR: -.CS -typedef void \fBTk_GeomRequestProc\fR( - ClientData \fIclientData\fR, - Tk_Window \fItkwin\fR); -.CE -The parameters to \fIrequestProc\fR will be identical to the -corresponding parameters passed to \fBTk_ManageGeometry\fR. -\fIclientData\fR usually points to a data -structure containing application-specific information about -how to manage \fItkwin\fR's geometry. -.PP -The \fIlostSlaveProc\fR field of \fImgrPtr\fR points to another -procedure in the geometry manager. -Tk will invoke \fIlostSlaveProc\fR if some other manager -calls \fBTk_ManageGeometry\fR to claim -\fItkwin\fR away from the current geometry manager. -\fIlostSlaveProc\fR is not invoked if \fBTk_ManageGeometry\fR is -called with a NULL value for \fImgrPtr\fR (presumably the current -geometry manager has made this call, so it already knows that the -window is no longer managed), nor is it called if \fImgrPtr\fR -is the same as the window's current geometry manager. -\fIlostSlaveProc\fR should have -arguments and results that match the following prototype: -.CS -typedef void \fBTk_GeomLostSlaveProc\fR( - ClientData \fIclientData\fR, - Tk_Window \fItkwin\fR); -.CE -The parameters to \fIlostSlaveProc\fR will be identical to the -corresponding parameters passed to \fBTk_ManageGeometry\fR. -.SH KEYWORDS -callback, geometry, managed, request, unmanaged |