Tk_ManageGeometry(3)

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.

     const Tk_GeomMgr *mgrPtr (in)            Pointer   to   data
                                              structure  contain-
                                              ing     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 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 {
              const char *name;
              Tk_GeomRequestProc *requestProc;

Tk                      Last change: 4.0                        1

Tk_ManageGeometry(3)  Tk Library Procedures  Tk_ManageGeometry(3)

              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  pro-
     cedure   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                      Last change: 4.0                        2