Tk_ManageGeometry(3Tk)					Tk_ManageGeometry(3Tk)

NAME    [Toc]    [Back]

     Tk_ManageGeometry - arrange to handle geometry requests for a window

SYNOPSIS    [Toc]    [Back]

     #include <tk.h>

     Tk_ManageGeometry(tkwin, mgrPtr, clientData)			      |

ARGUMENTS    [Toc]    [Back]

     Tk_Window	       tkwin	    (in)      Token for	window to be managed. |

     Tk_GeomMgr	       *mgrPtr	    (in)      Pointer to data structure	      |
					      containing 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 callbacks.

DESCRIPTION    [Toc]    [Back]

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



									Page 1






Tk_ManageGeometry(3Tk)					Tk_ManageGeometry(3Tk)



     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    [Toc]    [Back]

     callback, geometry, managed, request, unmanaged


									PPPPaaaaggggeeee 2222