XtRealizeWidget(3)		 XT FUNCTIONS		    XtRealizeWidget(3)



NAME
       XtRealizeWidget, XtIsRealized, XtUnrealizeWidget - realize and unreal-
       ize widgets

SYNTAX
       void XtRealizeWidget(Widget w);

       Boolean XtIsRealized(Widget w);

       void XtUnrealizeWidget(Widget w);

ARGUMENTS
       w	 Specifies the widget.

DESCRIPTION
       If the widget is already realized, XtRealizeWidget simply returns.
       Otherwise, it performs the following:

       o    Binds all action names in the widget's translation table to proce-

	    dures (see Section 10.1.2).

       o    Makes a post-order traversal of the widget tree rooted at the

	    specified widget and calls the change_managed procedure of each
	    composite widget that has one or more managed children.

       o    Constructs an XSetWindowAttributes structure filled in with infor-

	    mation derived from the Core widget fields and calls the realize
	    procedure for the widget, which adds any widget-specific
	    attributes and creates the X window.

       o    If the widget is not a subclass of compositeWidgetClass,

	    XtRealizeWidget returns; otherwise, it continues and performs the
	    following:

	    -	 Descends recursively to each of the widget's managed children

		 and calls the realize procedures.  Primitive widgets that
		 instantiate children are responsible for realizing those
		 children themselves.

	    -	 Maps all of the managed children windows that have

		 mapped_when_managed True.  (If a widget is managed but
		 mapped_when_managed is False, the widget is allocated visual
		 space but is not displayed.  Some people seem to like this to
		 indicate certain states.)

       If the widget is a top-level shell widget (that is, it has no parent),
       and mapped_when_managed is True, XtRealizeWidget maps the widget win-
       dow.

       The XtIsRealized function returns True if the widget has been realized,
       that is, if the widget has a nonzero X window ID.

       Some widget procedures (for example, set_values) might wish to operate
       differently after the widget has been realized.

       The XtUnrealizeWidget function destroys the windows of an existing wid-
       get and all of its children (recursively down the widget tree).	To
       recreate the windows at a later time, call XtRealizeWidget again.  If
       the widget was managed, it will be unmanaged automatically before its
       window is freed.

SEE ALSO
       XtManageChildren(3Xt)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface



X Version 11			  libXt 1.0.5		    XtRealizeWidget(3)

NAME - SYNTAX - ARGUMENTS - DESCRIPTION - SEE ALSO -