Name

XtSetMappedWhenManaged — change the value of a widget’s map_when_managed field. 

Synopsis

void XtSetMappedWhenManaged(w, map_when_managed)

    Widget w;
    Boolean map_when_managed;

Arguments

wSpecifies the widget. 

map_when_managed
Specifies a Boolean value that indicates the new value of the map_ when_managed field. 

Description

After a widget is realized, it must be mapped before it can become visible.  XtSetMappedWhenManaged controls whether this mapping occurs automatically (by default it does). 

If the widget is realized and managed and if map_when_managed is set to True, XtSetMappedWhenManaged maps the window.  If the widget is realized and managed and if the new value of map_when_managed is set to False, XtSetMappedWhenManaged  unmaps the window. 

XtSetMappedWhenManaged is a convenience function that is equivalent to (but slightly faster than) calling XtSetValues and setting the new value for the XtNmappedWhenManaged resource.  As an alternative to using XtSetMappedWhenManaged to control mapping, a client may set XtNmappedWhenManaged to False and use XtMapWidget and XtUnmapWidget explicitly. 

A widget is normally mapped if it is managed.  However, this behavior can be overridden by setting the Core XtNmappedWhenManaged resource for the widget when it is created or by setting the map_when_managed field to False. 

See Also

XtCreateManagedWidget(1), XtManageChildren(1), XtMapWidget(1), XtSetValues(1), XtUnmapWidget(1).