void XtUnmanageChildren(children
,num_children
) WidgetListchildren
; Cardinalnum_children
;
XtUnmanageChildren()
unmaps the specified widgets
and removes them from their parent's geometry management.
The widgets will disappear from the screen, and (depending
on its parent) may no longer have screen space allocated for
them.
Each of the widgets in the children
array must have
the same parent.
See the “Algorithm” section below for full details of the widget unmanagement procedure.
Unmanaging widgets is the usual method for temporarily
making them invisible. They can be re-managed with
XtManageChildren()
.
You can unmap a widget, but leave it under geometry
management by calling XtUnmapWidget()
. You can
destroy a widget's window without destroying the widget by
calling XtUnrealizeWidget()
. You can destroy a
widget completely with XtDestroyWidget()
.
If you are only going to unmanage a single widget, it is
more convenient to call XtUnmanageChild()
. It is
often more convenient to call XtUnmanageChild()
several times than it is to declare and initialize an array
of widgets to pass to XtUnmanageChildren()
. Calling
XtUnmanageChildren()
is more efficient, however,
because it only calls the parent's change_managed()
method once.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team