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.

       const Tk_GeomMgr *mgrPtr (in)            Pointer  to  data  structure  containing  information  about the
                                                geometry manager, or NULL  to  indicate  that  tkwin's  geometry
                                                should not 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 content 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 {
                  const 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 content window 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)