NAME

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


SYNOPSIS

       #include <tk.h>

       Tk_GeometryRequest(tkwin, reqWidth, reqHeight)

       Tk_SetInternalBorder(tkwin, width)


ARGUMENTS

       Tk_Window    tkwin        (in)      Window for which geom­
                                           etry      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

       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 informa­
       tion  will be passed to the window manager using the stan­
       dard 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

       ders  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.

       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

       geometry, request


Man(1) output converted with man2html