hpux man page for xtunmanagechildren

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)