NAME

XtConfigureWidget − move and/or resize widget. 

Synopsis

void XtConfigureWidget(w, x, y, width, height, border_width)

    Widget w;
    Position x;
    Position y;
    Dimension width;
    Dimension height;
    Dimension border_width;

Inputs

wSpecifies the widget; must be of class RectObj or any subclass thereof. 

x, ySpecify the widget’s new x and y coordinates. 

width, height, border_width
Specify the widget’s new dimensions.

Description

XtConfigureWidget() sets the size and position of a widget.  If the new size and position are the same as the widget’s current values, it returns immediately.  Otherwise XtConfigureWidget() writes the new x, y, width, height, and border_width values into instance fields of the object and, if the object is a widget and is realized, calls XConfigureWindow() on the widget’s window.  If either the new width or the new height is different from its old value, XtConfigureWidget() calls the widget’s resize() method to notify it of the size change. 

Usage

XtConfigureWidget() should be used only by a parent widget on one of its children widget.  If you want to set a widget size or position from an application, use XtSetValues() to set the XtNx, XtNy, XtNwidth, and XtNheight resources.  If widget wants to change its own size or location, it must use XtMakeGeometryRequest().  XtResizeWidget() and XtMoveWidget() are similar to XtConfigureWidget() but are simpler for the cases when you need only to resize or only to move a widget. 

See Also

XtMakeGeometryRequest(1), XtMakeResizeRequest(1), XtMoveWidget(1), XtResizeWidget(1). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates