TkGeometryRequest(3) Tk Library Procedures TkGeometryRequest(3)

NAME
       TkGeometryRequest,   TkSetMinimumRequestSize,   TkSetInternalBorder,
       TkSetInternalBorderEx - specify desired geometry  or  internal  border
       for a window

SYNOPSIS
       ##iinncclluuddee <>

       TTkkGGeeoommeettrryyRReeqquueesstt(tkwin, reqWidth, reqHeight)

       TTkkSSeettMMiinniimmuummRReeqquueessttSSiizzee(tkwin, minWidth, minHeight)

       TTkkSSeettIInntteerrnnaallBBoorrddeerr(tkwin, width)

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

AARRGGUUMMEENNTTSS
       TkWindow    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
       TTkkGGeeoommeettrryyRReeqquueesstt  is called by widget code to indicate its preference
       for the dimensions of a particular window.  The arguments to  TTkkGGeeoommee-
       ttrryyRReeqquueesstt  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 TTkkGGeeoommee-
       ttrryyRReeqquueesstt, 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 CCoonnffiigguurreeNNoottiiffyy event indicating that the  geometry
       change  has  occurred.   Widget  code should never call procedures like
       TTkkRReessiizzeeWWiinnddooww directly.  Instead, it should invoke TTkkGGeeoommeettrryyRReeqquueesstt
       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.

       TTkkSSeettIInntteerrnnaallBBoorrddeerr is called by widget code to indicate that the wid-
       get has an internal border.  This means that the widget draws a decora-
       tive 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 plac-
       ing any children of tkwin overlapping the  outermost  width  pixels  of
       tkwin's area.

       TTkkSSeettIInntteerrnnaallBBoorrddeerrEExx  works  like  TTkkSSeettIInntteerrnnaallBBoorrddeerr  but lets you
       specify different widths for different sides of the window.

       TTkkSSeettMMiinniimmuummRReeqquueessttSSiizzee 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  propa-
       gating geometry manager is used inside it.

       The  information  specified in calls to TTkkGGeeoommeettrryyRReeqquueesstt, TTkkSSeettMMiinnii-
       mmuummRReeqquueessttSSiizzee, TTkkSSeettIInntteerrnnaallBBoorrddeerr and TTkkSSeettIInntteerrnnaallBBoorrddeerrEExx can  be
       retrieved  using  the macros TTkkRReeqqWWiiddtthh, TTkkRReeqqHHeeiigghhtt, TTkkMMiinnRReeqqWWiiddtthh,
       TTkkMMiinnRReeqqHHeeiigghhtt, TTkkMMiinnRReeqqWWiiddtthh, TTkkIInntteerrnnaallBBoorrddeerrLLeefftt, TTkkIInntteerrnnaallBBoorr-
       ddeerrRRiigghhtt,  TTkkIInntteerrnnaallBBoorrddeerrTToopp  and  TTkkIInntteerrnnaallBBoorrddeerrBBoottttoomm.  See the
       TTkkWWiinnddoowwIIdd manual entry for details.


KKEEYYWWOORRDDSS
       geometry, request



Tk                                    8.4                TkGeometryRequest(3)