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 wid-
       gets

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,	Dimen-
	      sion 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
       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	geome-
       try  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	resize 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.0		  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+14.3.quarterly>

home | help