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 {
                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

Tk                                                     4.0                                Tk_ManageGeometry(3tk)