NAME

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

SYNOPSIS

       #include <tk.h>

       Tk_GeometryRequest(tkwin, reqWidth, reqHeight)

       Tk_SetMinimumRequestSize(tkwin, minWidth, minHeight)

       Tk_SetInternalBorder(tkwin, width)

       Tk_SetInternalBorderEx(tkwin, left, right, top, bottom)

ARGUMENTS

       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 minWidth (in)                   Desired minimum requested width for  tkwin,  in  pixel
                                           units.

       int minHeight (in)                  Desired  minimum  requested height for tkwin, in pixel
                                           units.

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

       int left (in)                       Space  to  leave  for left side of internal border for
                                           tkwin, in pixel units.

       int right (in)                      Space to leave for right side of internal  border  for
                                           tkwin, in pixel units.

       int top (in)                        Space  to  leave  for  top side of internal border for
                                           tkwin, in pixel units.

       int bottom (in)                     Space to leave for bottom side of internal border  for
                                           tkwin, in pixel units.
_________________________________________________________________________________________________

DESCRIPTION

       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.

       Tk_SetInternalBorderEx  works  like  Tk_SetInternalBorder  but  lets you specify different
       widths for different sides of the window.

       Tk_SetMinimumRequestSize is called by widget code to  indicate  that  a  geometry  manager
       should  request  at  least  this  size  for the widget.  This allows a widget to have some
       control over its size when a propagating geometry manager is used inside it.

       The  information  specified  in  calls  to  Tk_GeometryRequest,  Tk_SetMinimumRequestSize,
       Tk_SetInternalBorder   and  Tk_SetInternalBorderEx  can  be  retrieved  using  the  macros
       Tk_ReqWidth,    Tk_ReqHeight,     Tk_MinReqWidth,     Tk_MinReqHeight,     Tk_MinReqWidth,
       Tk_InternalBorderLeft,        Tk_InternalBorderRight,       Tk_InternalBorderTop       and
       Tk_InternalBorderBottom.  See the Tk_WindowId manual entry for details.

KEYWORDS

       geometry, request