summaryrefslogtreecommitdiffstats
path: root/tk8.6/doc/ManageGeom.3
diff options
context:
space:
mode:
Diffstat (limited to 'tk8.6/doc/ManageGeom.3')
-rw-r--r--tk8.6/doc/ManageGeom.390
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