[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Widget Writer's Guide


XmeReplyToQueryGeometry

Handles standard geometry requests

Format

#include <Xm/XmP.h>
XtGeometryResult
XmeReplyToQueryGeometryWidget
widgetXtWidgetGeometry
*intendedXtWidgetGeometry
*desired

DESCRIPTION

A query_geometry method can call XmeReplyToQueryGeometry in order to handle certain kinds of geometry requests. XmeReplyToQueryGeometry has an important limitation; it returns an XtGeometryResult value based solely on width and height values. That is, XmeReplyToQueryGeometry ignores other characteristics of widget geometry, such as starting position and border width. Therefore, if your query_geometry method needs to analyze any of these other characteristics, then you need to write your own code, rather than relying on XmeReplyToQueryGeometry.

Your widget must determine its preferred size prior to calling XmeReplyToQueryGeometry. To be more precise, you need only determine the widget's preferred width and height. The desired variable holds the widget's preferred dimensions.

widget
Specifies the current widget.

intended
Specifies the geometry proposed by the parent of widget.

desired
Specifies the geometry preferred by widget.

RETURN

Returns XtGeometryYes if the intended geometry matches the desired geometry, and if the parent of widget intends to use these values. Otherwise, returns XtGeometryNo if the desired width and height match the widget's current width and height. Otherwise, returns XtGeometryAlmost.

RELATED

XtResizeRequest(3).


[ Previous | Next | Contents | Glossary | Home | Search ]