XtRealizeWidget(3Xt) XT FUNCTIONS XtRealizeWidget(3Xt)NAME
XtRealizeWidget, XtIsRealized, XtUnrealizeWidget - realize
and unrealize widgets
SYNTAX
void XtRealizeWidget(w)
Widget w;
Boolean XtIsRealized(w)
Widget w;
void XtUnrealizeWidget(w)
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 procedures (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 information derived from the Core widget
fields and calls the realize procedure for the wid-
get, which adds any widget-specific attributes and
creates the X window.
o If the widget is not a subclass of
compositeWidgetClass, XtRealizeWidget returns; other-
wise, it continues and performs the following:
- Descends recursively to each of the widget's
managed children and calls the realize proce-
dures. Primitive widgets that instantiate chil-
dren are responsible for realizing those chil-
dren 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 dis-
played. Some people seem to like this to indi-
cate certain states.)
If the widget is a top-level shell widget (that is, it has
no parent), and mapped_when_managed is True,
X Version 11 Release 6.4 1
XtRealizeWidget(3Xt) XT FUNCTIONS XtRealizeWidget(3Xt)
XtRealizeWidget maps the widget window.
The XtIsRealized function returns True if the widget has
been realized, that is, if the widget has a nonzero X win-
dow 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 widget 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 man-
aged, it will be unmanaged automatically before its window
is freed.
SEE ALSOXtManageChildren(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
X Version 11 Release 6.4 2
