table of contents
XtRealizeWidget(3) | XT FUNCTIONS | XtRealizeWidget(3) |
NAME¶
XtRealizeWidget, XtIsRealized, XtUnrealizeWidget - realize and unrealize widgetsSYNTAX¶
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:- •
- Binds all action names in the widget's translation table to procedures (see Section 10.1.2).
- •
- 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.
- •
- Constructs an XSetWindowAttributes structure filled in with information 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.
- •
- 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.)
SEE ALSO¶
XtManageChildren(3)libXt 1.1.4 | X Version 11 |