XtChangeManagedSet(3X)						   XT FUNCTIONS 					    XtChangeManagedSet(3X)

NAME

       XtChangeManagedSet - manage and unmanage children at the same time

SYNTAX

       void XtChangeManagedSet(unmanage_children, num_unmanage_children, manage_children, num_manage_children, do_change_proc, client_data)
	     WidgetList unmanage_children;
	     Cardinal num_unmanage_children;
	     WidgetList manage_children;
	     Cardinal num_manage_children;
	     XtDoChangeProc do_change_proc;
	     XtPointer client_data;

ARGUMENTS

       unmanage_children
		 Specifies the list of widget children to remove from the managed set.

       num_unmanage_children
		 Specifies the number of entries in the unmanage_children list.

       manage_children
		 Specifies the list of widget children to add to the managed set.

       num_manage_children
		 Specifies the number of entries in the manage_children list.

       do_change_proc
		 Specifies a procedure to invoke between unmanaging and managing the children, or NULL.

       client_data
		 Specifies the client data to be passed to the hook precedure.

DESCRIPTION

       The XtChangeManagedSet function performs the following:

       o    Issues an error if the widgets specified in the manage_children and the unmanage_children lists to no all have the same parent, or if
	    that parent is not a subclass of compositeWidgetClass.

       o    Returns immediately if the common parent is being destroyed.

       o    If no CompositeClassExtension is defined, or a CompositeClassExtension is defined but with an allows_change_managed_set field with a
	    value of False, and XtChangeManagedSet was invoked with a non-NULL post_unmanage_pre_manage_hook procedure then XtChangeManagedSet
	    performs the following:

	    -	 Calls XtUnmanageChildren (unmanage_children, num_unmanage_children).

	    -	 Calls the post_unmanage_pre_manage_hook specified.

	    -	 Calls XtManageChildren (manage_children, num_manage_children) and then returns immediately.

       o    Otherwise, if a CompositeClassExtension is defined with an allows_change_managed_set field with a value of True, or if no Composite-
	    ClassExtension is defined, and XtChangeManagedSetwas post_unmanage_pre_manage_hook procedure, then the following is performed:

	    -	 For each child on the unmanage_children list; if the child is already unmanaged or is being destroyed it is ignored, otherwise it
		 is marked as being unmanaged and if it is realized it is made nonvisible by being unmapped.

	    -	 If the post_unmanage_pre_manage_hook procdedure is non-NULL then it is invoked as specified.

	    -	 For each child on the manage_children list; if the child is already managed or it is being destroyed it is ignored, otherwise it
		 is marked as managed

       o    If the parent is realized and after all children have been marked, the change_managed method of the parent is invoked and subsequently
	    some of the newly managed children are made viewable by:

	    -	 Calling XtRealizeWidget on each of the previously unmanaged child that is unrealized.

	    -	 Mapping each previously unmanaged child that has map_when_managed True.

SEE ALSO

       XtDoChangeProc(3X), XtManageChildren(3X), XtManageChild(3X), XtUnmanageChildren(3X), XtUnmanageChild(3X), XtIsManaged(3X)

X Version 11							     Release 6						    XtChangeManagedSet(3X)