2.13. Widget Placement and Sizing   

To move a sibling widget of the child making the geometry request, the parent uses XtMoveWidget. 


    void XtMoveWidget(w, x, y)

          Widget w;

          Position x;

          Position y;

           w Specifies the widget.  Must be of class RectObj or any subclass thereof.

           x

           y Specify the new widget x and y coordinates.
The XtMoveWidget function returns immediately if the specified geometry fields are the same as the old values. Otherwise, XtMoveWidget writes the new x and y values into the object and, if the object is a widget and is realized, issues an Xlib XMoveWindow call on the widget's window.

To resize a sibling widget of the child making the geometry request, the parent uses XtResizeWidget. 


    void XtResizeWidget(w, width, height, border_width)

          Widget w;

          Dimension width;

          Dimension height;

          Dimension border_width;

           w Specifies the widget.  Must be of class RectObj or any subclass thereof.

           width

           height

           border_width Specify the new widget size.
The XtResizeWidget function returns immediately if the specified geometry fields are the same as the old values. Otherwise, XtResizeWidget writes the new width, height, and border_width values into the object and, if the object is a widget and is realized, issues an XConfigureWindow call on the widget's window.

If the new width or height is different from the old values, XtResizeWidget calls the object's resize procedure to notify it of the size change.

To move and resize the sibling widget of the child making the geometry request, the parent uses XtConfigureWidget. 


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

          Widget w;

          Position x;

          Position y;

          Dimension width;

          Dimension height;

          Dimension border_width;

           w Specifies the widget.  Must be of class RectObj or any subclass thereof.

           x

           y Specify the new widget x and y coordinates.

           width

           height

           border_width Specify the new widget size.
The XtConfigureWidget function returns immediately if the specified new geometry fields are all equal to the current values. Otherwise, XtConfigureWidget writes the new x, y, width, height, and border_width values into the object and, if the object is a widget and is realized, makes an Xlib XConfigureWindow call on the widget's window.

If the new width or height is different from its old value, XtConfigureWidget calls the object's resize procedure to notify it of the size change; otherwise, it simply returns.

To resize a child widget that already has the new values of its width, height, and border width, the parent uses XtResizeWindow. 


    void XtResizeWindow(w)

          Widget w;

           w Specifies the widget.  Must be of class Core or any subclass thereof.
The XtResizeWindow function calls the XConfigureWindow Xlib function to make the window of the specified widget match its width, height, and border width. This request is done unconditionally because there is no inexpensive way to tell if these values match the current values. Note that the widget's resize procedure is not called.

There are very few times to use XtResizeWindow; instead, the parent should use XtResizeWidget.