Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

XtMakeGeometryRequest(3Xt)

XtQueryGeometry(3Xt)

XtConfigureWidget(3Xt)               BSD                XtConfigureWidget(3Xt)



NAME
     XtConfigureWidget, XtMoveWidget, XtResizeWidget - move and resize widgets

SYNTAX
     void XtConfigureWidget(w, x, y, width, height, border_width)
           Widget w;
           Position x;
           Position y;
           Dimension width;
           Dimension height;
           Dimension border_width;

     void XtMoveWidget(w, x, y)
           Widget w;
           Position x;
           Position y;

     void XtResizeWidget(w, width, height, border_width)
           Widget w;
           Dimension width;
           Dimension height;
           Dimension border_width;

     void XtResizeWindow(w)
           Widget w;

ARGUMENTS
     width
     height
     border_width
               Specify the new widget size.

     w         Specifies the widget.

     x
     y         Specify the new widget x and y coordinates.

DESCRIPTION
     The XtConfigureWidget function returns immediately if the specified
     geometry fields are the same as the old values.  Otherwise,
     XtConfigureWidget writes the new x, y, width, height, and border_width
     values into the widget and, if the widget is realized, makes an Xlib
     XConfigureWindow call on the widget's window.

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

     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 widget and, if the widget is realized,
     issues an Xlib XMoveWindow call on the widget's window.

     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 widget and, if
     the widget is realized, issues an XConfigureWindow call on the widget's
     window.

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

     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
     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, you should use
     XtResizeWidget.

SEE ALSO
     XtMakeGeometryRequest(3Xt), XtQueryGeometry(3Xt)
     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026