Name

XtUnmanageChildren — remove a list of children from a parent widget’s managed list. 

Synopsis

void XtUnmanageChildren(children, num_children)

    WidgetList children;
    Cardinal num_children;

Arguments

childrenSpecifies a list of child widgets. 

num_children
Specifies the number of children.

Description

XtUnmanageChildren removes a list of widgets from a parent widget’s geometry management list.  It performs the following:

•Issues an error if children do not all have the same parent or if the parent is not a subclass of compositeWidgetClass. 

•Returns immediately if the common parent is being destroyed; otherwise, for each unique child on the list, XtUnmanageChildren performs the following:

−Marks children visible if they are not being destroyed and are currently managed.  For each visible child, if the child is realized, it makes it invisible by unmapping it. 

−If the parent is realized, it calls the change_managed routine of the widgets’ parent after all children have been marked. 

XtUnmanageChildren does not destroy children.  Removing widgets from a parent’s managed set is often a temporary banishment--some time later, they may be managed again.  To destroy widgets entirely, see XtDestroyWidget. 

Note that XtManageChild, XtManageChildren, XtUnmanageChild, and XtUnmanageChildren are low-level routines that are used by generic composite widget building routines.  In addition, composite widgets can provide widget-specific, high-level convenience procedures to let applications create and manage children more easily. 

Structures

typedef Widget ∗WidgetList;

See Also

XtDestroyWidget(1), XtIsManaged(1), XtManageChild(1), XtManageChildren(1), XtUnmanageChild(1).