XtChangeManagedSet(3X) XT FUNCTIONS XtChangeManagedSet(3X)NAMEXtChangeManagedSet - manage and unmanage children at the same time
SYNTAX
void XtChangeManagedSet(unmanage_children, num_unmanage_children, man‐
age_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 man‐
aged 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 manag‐
ing the children, or NULL.
client_data
Specifies the client data to be passed to the hook precedure.
DESCRIPTION
The XtChangeManagedSet function performs the following:
· 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.
· Returns immediately if the common parent is being destroyed.
· If no CompositeClassExtension is defined, or a CompositeClassEx‐
tension 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 XtChangeMan‐
agedSet performs the following:
- Calls XtUnmanageChildren (unmanage_children, num_unman‐
age_children).
- Calls the post_unmanage_pre_manage_hook specified.
- Calls XtManageChildren (manage_children, num_manage_children)
and then returns immediately.
· Otherwise, if a CompositeClassExtension is defined with an
allows_change_managed_set field with a value of True, or if no
CompositeClassExtension 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, other‐
wise 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, oth‐
erwise it is marked as managed
· If the parent is realized and after all children have been marked,
the change_managed method of the parent is invoked and subse‐
quently 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 ALSOXtDoChangeProc(3X), XtManageChildren(3X), XtManageChild(3X), XtUnman‐
ageChildren(3X), XtUnmanageChild(3X), XtIsManaged(3X)X Version 11 Release 6 XtChangeManagedSet(3X)