Scroll to navigation

Tk_GeometryRequest(3tk) Tk Library Procedures Tk_GeometryRequest(3tk) 





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 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
    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
    different 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_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







  

    8.4
    Tk