Страницы справочника OS X

Эта страница руководства является частью версии 5.0 Инструментов XCode

Читать страницы руководства

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 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  par-ticular particular
       ticular  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_GeometryRe-quest Tk_GeometryRequest
       quest 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 dif-ferent different
       ferent 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_SetInternal-Border Tk_SetInternalBorder
       Border  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                                                   8.4                               Tk_GeometryRequest(3)