XtUnmanageChild() XtUnmanageChild()
Name
XtUnmanageChild - remove a widget from its parent's managed list.
Synopsis
void XtUnmanageChild(w)
Widget w;
Inputs
w Specifies the child widget to be unmanaged; must be of class RectObj or any subclass thereof.
Description
XtUnmanageChild() unmaps the specified widget and removes it from its parent's geometry management. The widget will disappear from the
screen, and (depending on its parent) may no longer have screen space allocated for it.
XtUnmanageChild() simply calls XtUnmanageChildren(). See that function for more information about the procedure for unmanaging a widget.
Usage
Unmanaging a widget is the usual method for temporarily making it invisible. It can be re-managed with XtManageChild().
You can unmap a widget, but leave it under geometry management by calling XtUnmapWidget(). You can destroy a widget's window without
destroying the widget by calling XtUnrealizeWidget(). You can destroy a widget completely with XtDestroyWidget().
If you will be unmanaging several sibling widgets, it is more efficient to call XtUnmanageChildren() because this only generates a single
call to the parent's change_managed() method. It is often more convenient to simply call XtUnmanageChild() several times, however.
See Also
XtIsManaged(1), XtManageChild(1), XtManageChildren(1), XtUnmanageChildren(1).
Xt - Geometry Management XtUnmanageChild()