bionic (3) Tk_ManageGeometry.3tk.gz

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