Страницы справочника OS X

Эта страница руководства является частью версии 5.0 Инструментов XCode

Читать страницы руководства

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 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 call-backs. callbacks.
                                                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 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_Manage-Geometry. Tk_ManageGeometry.
       Geometry.   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 cur-rent current
       rent 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_Man-ageGeometry. Tk_ManageGeometry.
       ageGeometry.


KEYWORDS
       callback, geometry, managed, request, unmanaged



Tk                                                   4.0                                Tk_ManageGeometry(3)