Name
XtUnrealizeWidget — destroy the windows associated with a widget and its descendants.
Synopsis
void XtUnrealizeWidget(w)
Widget w;
Arguments
wSpecifies the widget.
Description
XtUnrealizeWidget destroys the windows associated with a widget and its descendants.
If the widget is currently unrealized, XtUnrealizeWidget simply returns; otherwise, it performs the following:
•Unmanages the widget if the widget is managed.
•Makes a post-order (child to parent) traversal of the widget tree rooted at the specified widget and, for each widget that has declared a callback list named unrealizeCallback, executes the procedures on the XtNunrealizeCallback list.
•Destroys the widget’s window and any subwindows by calling XDestroyWindow on the specified widget’s window.
Any events that are either in the queue or that arrive following a call to XtUnrealizeWidget will be dispatched as if the window(s) of the unrealized widget(s) had never existed.
Note that this call simply destroys the windows associated with the widget(s). The widget instances themselves remain intact. To recreate the windows at a later time, call XtRealizeWidget again. Compare XtDestroyWidget, which destroys the widget(s) themselves.
If the widget was managed, it will be unmanaged automatically before its window is freed.