1Tk_GeometryRequest(3) Tk Library Procedures Tk_GeometryRequest(3)
2______________________________________________________________________________
6
8 Tk_GeometryRequest, Tk_SetMinimumRequestSize, Tk_SetInternalBorder,
9 Tk_SetInternalBorderEx - specify desired geometry or internal border
10 for a window
11
13 #include <tk.h>
14 Tk_GeometryRequest(tkwin, reqWidth, reqHeight)
16 Tk_SetMinimumRequestSize(tkwin, minWidth, minHeight)
18 Tk_SetInternalBorder(tkwin, width)
20 Tk_SetInternalBorderEx(tkwin, left, right, top, bottom)
22
24 Tk_Window tkwin (in) Window for which geometry is being
25 requested.
26 int reqWidth (in) Desired width for tkwin, in pixel
28 units.
29 int reqHeight (in) Desired height for tkwin, in pixel
31 units.
32 int minWidth (in) Desired minimum requested width for
34 tkwin, in pixel units.
35 int minHeight (in) Desired minimum requested height
37 for tkwin, in pixel units.
38 int width (in) Space to leave for internal border
40 for tkwin, in pixel units.
41 int left (in) Space to leave for left side of in‐
43 ternal border for tkwin, in pixel
44 units.
45 int right (in) Space to leave for right side of
47 internal border for tkwin, in pixel
48 units.
49 int top (in) Space to leave for top side of in‐
51 ternal border for tkwin, in pixel
52 units.
53 int bottom (in) Space to leave for bottom side of
55 internal border for tkwin, in pixel
56 units.
57______________________________________________________________________________
58
60 Tk_GeometryRequest is called by widget code to indicate its preference
61 for the dimensions of a particular window. The arguments to Tk_Geome‐
62 tryRequest are made available to the geometry manager for the window,
63 which then decides on the actual geometry for the window. Although ge‐
64 ometry managers generally try to satisfy requests made to Tk_Geome‐
65 tryRequest, there is no guarantee that this will always be possible.
66 Widget code should not assume that a geometry request will be satisfied
67 until it receives a ConfigureNotify event indicating that the geometry
68 change has occurred. Widget code should never call procedures like
69 Tk_ResizeWindow directly. Instead, it should invoke Tk_GeometryRequest
70 and leave the final geometry decisions to the geometry manager.
71 If tkwin is a top-level window, then the geometry information will be
73 passed to the window manager using the standard ICCCM protocol.
74 Tk_SetInternalBorder is called by widget code to indicate that the wid‐
76 get has an internal border. This means that the widget draws a decora‐
77 tive border inside the window instead of using the standard X borders,
78 which are external to the window's area. For example, internal borders
79 are used to draw 3-D effects. Width specifies the width of the border
80 in pixels. Geometry managers will use this information to avoid plac‐
81 ing any children of tkwin overlapping the outermost width pixels of tk‐
82 win's area.
83 Tk_SetInternalBorderEx works like Tk_SetInternalBorder but lets you
85 specify different widths for different sides of the window.
86 Tk_SetMinimumRequestSize is called by widget code to indicate that a
88 geometry manager should request at least this size for the widget.
89 This allows a widget to have some control over its size when a propa‐
90 gating geometry manager is used inside it.
91 The information specified in calls to Tk_GeometryRequest, Tk_SetMini‐
93 mumRequestSize, Tk_SetInternalBorder and Tk_SetInternalBorderEx can be
94 retrieved using the macros Tk_ReqWidth, Tk_ReqHeight, Tk_MinReqWidth,
95 Tk_MinReqHeight, Tk_MinReqWidth, Tk_InternalBorderLeft, Tk_InternalBor‐
96 derRight, Tk_InternalBorderTop and Tk_InternalBorderBottom. See the
97 Tk_WindowId manual entry for details.
98
100 geometry, request
101Tk 8.4 Tk_GeometryRequest(3)