1 .\" Copyright 1993 X Consortium
3 .\" Permission is hereby granted, free of charge, to any person obtaining
4 .\" a copy of this software and associated documentation files (the
5 .\" "Software"), to deal in the Software without restriction, including
6 .\" without limitation the rights to use, copy, modify, merge, publish,
7 .\" distribute, sublicense, and/or sell copies of the Software, and to
8 .\" permit persons to whom the Software is furnished to do so, subject to
9 .\" the following conditions:
11 .\" The above copyright notice and this permission notice shall be
12 .\" included in all copies or substantial portions of the Software.
14 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15 .\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 .\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 .\" OTHER DEALINGS IN THE SOFTWARE.
22 .\" Except as contained in this notice, the name of the X Consortium shall
23 .\" not be used in advertising or otherwise to promote the sale, use or
24 .\" other dealings in this Software without prior written authorization
25 .\" from the X Consortium.
28 .ds xT X Toolkit Intrinsics \- C Language Interface
30 .ds xW X Toolkit Athena Widgets \- C Language Interface
31 .ds xL Xlib \- C Language X Interface
32 .ds xC Inter-Client Communication Conventions Manual
35 .hw XtMake-Geometry-Request XtMake-Resize-Request wid-get
42 .\".if \\n(VS>=40 .vs \\n(VSu
43 .\".if \\n(VS<=39 .vs \\n(VSp
54 .de IN \" send an index entry to the stderr
57 .ie t \\$1\fB\^\\$2\^\fR\\$3
58 .el \\$1\fI\^\\$2\^\fP\\$3
61 .ie t \fB\^\\$1\^\fR\\$2
62 .el \fI\^\\$1\^\fP\\$2
65 .TH XtMakeGeometryRequest __libmansuffix__ __xorgversion__ "XT FUNCTIONS"
67 XtMakeGeometryRequest, XtMakeResizeRequest \- make geometry manager request
70 XtGeometryResult XtMakeGeometryRequest(Widget \fIw\fP, XtWidgetGeometry
71 *\fIrequest\fP, XtWidgetGeometry *\fIreply_return\fP);
73 XtGeometryResult XtMakeResizeRequest(Widget \fIw\fP, Dimension \fIwidth\fP,
74 \fIheight\fP, Dimension *\fIwidth_return\fP, Dimension *\fIheight_return\fP);
76 .IP \fIreply_return\fP 1i
77 Returns the allowed widget size or may be NULL
78 if the requesting widget is not interested in handling
79 .ZN XtGeometryAlmost .
81 Specifies the desired widget geometry (size, position, border width,
83 .ds Wi that is making the request
85 Specifies the widget \*(Wi.
86 .IP \fIwidth_return\fP 1i
89 .IP \fIheight_return\fP 1i
90 Return the allowed widget width and height.
92 Depending on the condition,
93 .ZN XtMakeGeometryRequest
94 performs the following:
96 If the widget is unmanaged or the widget's parent is not realized,
97 it makes the changes and returns
100 If the parent is not a subclass of
101 .ZN compositeWidgetClass
102 or the parent's geometry_manager is NULL,
105 If the widget's being_destroyed field is
110 If the widget x, y, width, height and border_width fields are
111 all equal to the requested values,
114 otherwise, it calls the parent's geometry_manager procedure
115 with the given parameters.
117 If the parent's geometry manager returns
121 is not set in the request_mode
122 and if the widget is realized,
123 .ZN XtMakeGeometryRequest
126 Xlib function to reconfigure the widget's window (set its size, location,
127 and stacking order as appropriate).
129 If the geometry manager returns
131 the change has been approved and actually has been done.
133 .ZN XtMakeGeometryRequest
134 does no configuring and returns
136 .ZN XtMakeGeometryRequest
141 .ZN XtMakeGeometryRequest
142 returns the resulting value from the parent's geometry manager.
144 Children of primitive widgets are always unmanaged; thus,
145 .ZN XtMakeGeometryRequest
148 when called by a child of a primitive widget.
151 .ZN XtMakeResizeRequest
152 function, a simple interface to
153 .ZN XtMakeGeometryRequest ,
156 structure and specifies that width and height should change.
157 The geometry manager is free to modify any of the other window attributes
158 (position or stacking order) to satisfy the resize request.
159 If the return value is
160 .ZN XtGeometryAlmost ,
161 width_return and height_return contain a compromise width and height.
162 If these are acceptable,
163 the widget should immediately make an
164 .ZN XtMakeResizeRequest
165 and request that the compromise width and height be applied.
166 If the widget is not interested in
169 it can pass NULL for width_return and height_return.
171 XtConfigureWidget(__libmansuffix__),
172 XtQueryGeometery(__libmansuffix__)