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 man-
                                                aged.

       Tk_GeomMgr        *mgrPtr      (in)      Pointer to data structure con-
                                                taining  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.
_________________________________________________________________

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 geom-
       etry 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  man-
       ager.

       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,

       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(3)