Tk_GeometryRequest(3Tk)				       Tk_GeometryRequest(3Tk)

NAME    [Toc]    [Back]

     Tk_GeometryRequest, Tk_SetInternalBorder -	specify	desired	geometry or
     internal border for a window

SYNOPSIS    [Toc]    [Back]

     #include <tk.h>

     Tk_GeometryRequest(tkwin, reqWidth, reqHeight)

     Tk_SetInternalBorder(tkwin, width)

ARGUMENTS    [Toc]    [Back]

     Tk_Window	  tkwin	       (in)	 Window	for which geometry is being
					 requested.

     int	  reqWidth     (in)	 Desired width for tkwin, in pixel
					 units.

     int	  reqHeight    (in)	 Desired height	for tkwin, in pixel
					 units.

     int	  width	       (in)	 Space to leave	for internal border
					 for tkwin, in pixel units.

DESCRIPTION    [Toc]    [Back]

     Tk_GeometryRequest	is called by widget code to indicate its preference
     for the dimensions	of a particular	window.	 The arguments to
     Tk_GeometryRequest	are made available to the geometry manager for the
     window, which then	decides	on the actual geometry for the window.
     Although geometry managers	generally try to satisfy requests made to
     Tk_GeometryRequest, there is no guarantee that this will always be
     possible.	Widget code should not assume that a geometry request will be
     satisfied until it	receives a ConfigureNotify event indicating that the
     geometry change has occurred.  Widget code	should never call procedures
     like Tk_ResizeWindow directly.  Instead, it should	invoke
     Tk_GeometryRequest	and leave the final geometry decisions to the geometry
     manager.

     If	tkwin is a top-level window, then the geometry information will	be
     passed to the window manager using	the standard ICCCM protocol.

     Tk_SetInternalBorder is called by widget code to indicate that the	widget
     has an internal border.  This means that the widget draws a decorative
     border inside the window instead of using the standard X borders, which
     are external to the window's area.	 For example, internal borders are
     used to draw 3-D effects.	Width specifies	the width of the border	in
     pixels.  Geometry managers	will use this information to avoid placing any
     children of tkwin overlapping the outermost width pixels of tkwin's area.






									Page 1






Tk_GeometryRequest(3Tk)				       Tk_GeometryRequest(3Tk)



     The information specified in calls	to Tk_GeometryRequest and
     Tk_SetInternalBorder can be retrieved using the macros Tk_ReqWidth,
     Tk_ReqHeight, and Tk_InternalBorderWidth.	See the	Tk_WindowId manual
     entry for details.

KEYWORDS    [Toc]    [Back]

     geometry, request


									PPPPaaaaggggeeee 2222