X Version 11 (Release 6.1)

XtMakeGeometryRequest(X3xt)


XtMakeGeometryRequest -- make geometry manager request

Synopsis

XtGeometryResult XtMakeGeometryRequest(w, request, reply_return)
    Widget w;
    XtWidgetGeometry *request;
    XtWidgetGeometry *reply_return;

XtGeometryResult XtMakeResizeRequest(w, width, height, width_return, height_return) Widget w; Dimension width, height; Dimension *width_return, *height_return

Arguments


reply_return
Returns the allowed widget size or may be NULL if the requesting widget is not interested in handling XtGeometryAlmost.

request
Specifies the desired widget geometry (size, position, border width, and stacking order).

w
Specifies the widget that is making the request.

width_return,
height_return
Return the allowed widget width and height.

Description

Depending on the condition, XtMakeGeometryRequest performs the following:

Otherwise, XtMakeGeometryRequest returns the resulting value from the parent's geometry manager.

Children of primitive widgets are always unmanaged; thus, XtMakeGeometryRequest always returns XtGeometryYes when called by a child of a primitive widget.

The XtMakeResizeRequest function, a simple interface to XtMakeGeometryRequest, creates a XtWidgetGeometry structure and specifies that width and height should change. The geometry manager is free to modify any of the other window attributes (position or stacking order) to satisfy the resize request. If the return value is XtGeometryAlmost, width_return and height_return contain a compromise width and height. If these are acceptable, the widget should immediately make an XtMakeResizeRequest and request that the compromise width and height be applied. If the widget is not interested in XtGeometryAlmost replies, it can pass NULL for width_return and height_return.

References

XtConfigureWidget(X3xt), XtQueryGeometry(X3xt)

X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface

Dt man


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004