XtUnmanageChildren(3X) XT FUNCTIONS XtUnmanageChildren(3X)
NAME
XtUnmanageChildren - unmanage children
SYNTAX
typedef Widget *WidgetList;
void XtUnmanageChildren(children, num_children)
WidgetList children;
Cardinal num_children;
ARGUMENTS
children Specifies a list of child widgets.
num_children
Specifies the number of children.
DESCRIPTION
The XtUnmanageChildren function performs the following:
o Issues an error if the children do not all have the same parent or if the parent is not a subclass of compositeWidgetClass.
o Returns immediately if the common parent is being destroyed; otherwise, for each unique child on the list, XtUnmanageChildren performs
the following:
- Ignores the child if it already is unmanaged or is being destroyed and marks it if not.
- If the child is realized, it makes it nonvisible by unmapping it.
o Calls the change_managed routine of the widgets' parent after all children have been marked if the parent is realized.
XtUnmanageChildren does not destroy the children widgets. Removing widgets from a parent's managed set is often a temporary banishment,
and, some time later, you may manage the children again.
SEE ALSO
XtManageChildren(3X), XtManageChild(3X), XtUnmanageChild(3X), XtChangeManagedSet(3X), XtIsManged(3X)
X Version 11 Release 6 XtUnmanageChildren(3X)