Tk_ManageGeometry(3) Tk (4.0) 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
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 {
Page 1 (printed 2/26/99)
Tk_ManageGeometry(3) Tk (4.0) Tk_ManageGeometry(3)
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_ManageGeometry.
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 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 the
corresponding parameters passed to Tk_ManageGeometry.
KEYWORDS
callback, geometry, managed, request, unmanaged
Page 2 (printed 2/26/99)
