Tk_GeometryRequest(3) Tk Library Procedures Tk_GeometryRequest(3)



_________________________________________________________________

NAME
       Tk_GeometryRequest, Tk_SetMinimumRequestSize, Tk_SetInter-
       nalBorder, Tk_SetInternalBorderEx - specify desired geome-
       try or internal border for a window

SYNOPSIS
       #include 

       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 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          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 bor-
                                           der  for   tkwin,   in
                                           pixel units.

       int          bottom       (in)      Space   to  leave  for
                                           bottom side of  inter-
                                           nal  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  exter-
       nal  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  over-
       lapping 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 indi-
       cate 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_Set-
       InternalBorderEx   can   be  retrieved  using  the  macros
       Tk_ReqWidth,   Tk_ReqHeight,   Tk_MinReqWidth,   Tk_MinRe-
       qHeight,  Tk_MinReqWidth, Tk_InternalBorderLeft, Tk_Inter-
       nalBorderRight, Tk_InternalBorderTop  and  Tk_InternalBor-
       derBottom.   See the Tk_WindowId manual entry for details.


KEYWORDS
       geometry, request



Tk                             8.4          Tk_GeometryRequest(3)