Tk Library Procedures Tk_ManageGeometry(3TK)
_________________________________________________________________
NAME
Tk_ManageGeometry - arrange to handle geometry requests for
a windowSYNOPSIS
#include
Tk_ManageGeometry(tkwin, mgrPtr, clientData)
ARGUMENTSTk_Window tkwin (in) Token for window to
be managed.Tk_GeomMgr *mgrPtr (in) Pointer to data
structure contain-
ing information about the geometry manager, or NULL to indicate that tkwin's geometry shouldn't be managed anymore. The data structure pointed to by mgrPtr must be static: Tk keeps a reference to it as long as the window is managed.ClientData clientData (in) Arbitrary one-word
value to pass to geometry manager callbacks._________________________________________________________________
DESCRIPTION
Tk_ManageGeometry arranges for a particular geometry
manager, described by the mgrPtr argument, to control the geometry of a particular slave window, given by tkwin. If tkwin was previously managed by some other geometry manager, the previous manager loses control in favor of the new one. If mgrPtr is NULL, geometry management is cancelled for tkwin. The structure pointed to by mgrPtr contains information about the geometry manager: typedef struct { char *name; Tk Last change: 4.0 1Tk Library Procedures Tk_ManageGeometry(3TK)
Tk_GeomRequestProc *requestProc;
Tk_GeomLostSlaveProc *lostSlaveProc;
} Tk_GeomMgr;
The name field is the textual name for the geometry manager, such as pack or place; this value will be returned by the command winfo manager. requestProc is a procedure in the geometry manager that willbe invoked whenever Tk_GeometryRequest is called by the
slave to change its desired geometry. requestProc should have arguments and results that match the typeTk_GeomRequestProc:
typedef void Tk_GeomRequestProc(
ClientData clientData,Tk_Window tkwin);
The parameters to requestProc will be identical to thecorresponding parameters passed to Tk_ManageGeometry.
clientData usually points to a data structure containingapplication-specific information about how to manage tkwin's
geometry.The lostSlaveProc field of mgrPtr points to another pro-
cedure in the geometry manager. Tk will invokelostSlaveProc if some other manager calls Tk_ManageGeometry
to claim tkwin away from the current geometry manager.lostSlaveProc is not invoked if Tk_ManageGeometry is called
with a NULL value for mgrPtr (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 mgrPtr is the same as the window's current geometry manager. lostSlaveProc should have arguments and results that match the following prototype:typedef void Tk_GeomLostSlaveProc(
ClientData clientData,Tk_Window tkwin);
The parameters to lostSlaveProc will be identical to thecorresponding parameters passed to Tk_ManageGeometry.
KEYWORDS callback, geometry, managed, request, unmanagedATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes: Tk Last change: 4.0 2Tk Library Procedures Tk_ManageGeometry(3TK)
_______________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE|
|____________________|__________________|_
| Availability | runtime/tk-8 |
|____________________|__________________|_
| Interface Stability| Uncommitted ||____________________|_________________|
NOTES Source for Tk is available on http://opensolaris.org. Tk Last change: 4.0 3