Tk_ManageGeometry(3) Tk Library Procedures Tk_ManageGeometry(3)
____________________________________________________________________________________________________________
NAME
Tk_ManageGeometry - arrange to handle geometry requests for a window
SYNOPSIS
#include <tk.h>
Tk_ManageGeometry(tkwin, mgrPtr, clientData)
ARGUMENTS
Tk_Window tkwin (in) Token for window to be managed.
Tk_GeomMgr *mgrPtr (in) Pointer to data structure containing 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 call-backs. callbacks.
backs.
____________________________________________________________________________________________________________
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_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 will be invoked whenever Tk_GeometryRequest
is called by the slave to change its desired geometry. requestProc should have arguments and results
that match the type Tk_GeomRequestProc:
typedef void Tk_GeomRequestProc(
ClientData clientData,
Tk_Window tkwin);
The parameters to requestProc will be identical to the corresponding parameters passed to Tk_Manage-Geometry. Tk_ManageGeometry.
Geometry. clientData usually points to a data structure containing application-specific information
about how to manage tkwin's geometry.
The lostSlaveProc field of mgrPtr points to another procedure in the geometry manager. Tk will
invoke lostSlaveProc if some other manager calls Tk_ManageGeometry to claim tkwin away from the cur-rent current
rent 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 the corresponding parameters passed to Tk_Man-ageGeometry. Tk_ManageGeometry.
ageGeometry.
KEYWORDS
callback, geometry, managed, request, unmanaged
Tk 4.0 Tk_ManageGeometry(3)
|