DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

Tk_GeometryRequest(3tk)




Tk_GeometryRequest(3) Tk Library Procedures Tk_GeometryRequest(3)

_________________________________________________________________


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

Tk                      Last change: 8.4                        1

Tk_GeometryRequest(3) Tk Library Procedures Tk_GeometryRequest(3)

                                         side  of internal border
                                         for  tkwin,   in   pixel
                                         units.

     int bottom (in)                     Space to leave for  bot-
                                         tom   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  Con-
     figureNotify  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 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 outer-
     most 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 con-
     trol  over  its  size when a propagating geometry manager is
     used inside it.

Tk                      Last change: 8.4                        2

Tk_GeometryRequest(3) Tk Library Procedures Tk_GeometryRequest(3)

     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

Tk                      Last change: 8.4                        3


Man(1) output converted with man2html