NAME

XtUnmanageChild − remove a widget from its parent’s managed list. 

SYNOPSIS

void XtUnmanageChild(w)
    Widget w;

Inputs

wSpecifies the child widget to be unmanaged; must be of class RectObj or any subclass thereof. 

DESCRIPTION

XtUnmanageChild() unmaps the specified widget and removes it from its parent’s geometry management.  The widget will disappear from the screen, and (depending on its parent) may no longer have screen space allocated for it. 

XtUnmanageChild() simply calls XtUnmanageChildren().  See that function for more information about the procedure for unmanaging a widget. 

USAGE

Unmanaging a widget is the usual method for temporarily making it invisible.  It can be re-managed with XtManageChild(). 

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 will be unmanaging several sibling widgets, it is more efficient to call XtUnmanageChildren() because this only generates a single call to the parent’s change_managed() method.  It is often more convenient to simply call XtUnmanageChild() several times, however. 

SEE ALSO

XtIsManagedUNIX SYSTEM V/68, XtManageChildUNIX SYSTEM V/68, XtManageChildrenUNIX SYSTEM V/68, XtUnmanageChildrenUNIX SYSTEM V/68.