Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XtConfigureWidget(3)		  XT FUNCTIONS		    XtConfigureWidget(3)

NAME
     XtConfigureWidget, XtMoveWidget, XtResizeWidget - move and resize widgets

SYNTAX
     #include <X11/Intrinsic.h>

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

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

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

     void XtResizeWindow(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 geome-
     try 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,  XtResize-
     Widget 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 re-
     size procedure is not called.

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

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

X Version 11			   libXt 1.3.1		    XtConfigureWidget(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XtConfigureWidget&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help