xtsetmappedwhenmanaged(3) [x11r4 man page]

XtMapWidget(3)							   XT FUNCTIONS 						    XtMapWidget(3)

NAME

       XtMapWidget, XtSetMappedWhenManaged, XtUnmapWidget - map and unmap widgets

SYNTAX

       int XtMapWidget(Widget w);

       void XtSetMappedWhenManaged(Widget w, Boolean map_when_managed);

       int XtUnmapWidget(Widget w);

ARGUMENTS

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

       w	 Specifies the widget.

DESCRIPTION

       If the widget is realized and managed and if the new value of map_when_managed is True, XtSetMappedWhenManaged maps the window.	If the
       widget is realized and managed and if the new value of map_when_managed is False, it unmaps the window.	XtSetMappedWhenManaged is a conve-
       nience function that is equivalent to (but slightly faster than) calling XtSetValues and setting the new value for the mappedWhenManaged
       resource.  As an alternative to using XtSetMappedWhenManaged to control mapping, a client may set mapped_when_managed to False and use
       XtMapWidget and XtUnmapWidget explicitly.

SEE ALSO

       XtManageChildren(3Xt)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    libXt 1.0.5 						    XtMapWidget(3)

XtSetMappedWhenManaged()												  XtSetMappedWhenManaged()

Name
  XtSetMappedWhenManaged - set the value of a widget's XtNmappedWhenManaged resource and map or unmap the window.

Synopsis
  void XtSetMappedWhenManaged(w, map_when_managed)
	 Widget w;
	 Boolean map_when_managed;

Inputs
  w	    Specifies the widget.  Must be of class Core or any subclass thereof.

  map_when_managed
	    Specifies the new value of the map_when_managed field.

Description
  If  w  is realized and managed and if map_when_managed is set to True, XtSetMappedWhenManaged() maps the widget's window.  If the widget is
  realized and managed and if the new value of map_when_managed is set to False, XtSetMappedWhenManaged() unmaps  the  widget's  window.   In
  both	cases,	XtSetMappedWhenManaged()  sets	the  value of the widget's XtNmappedWhenManaged resource as specified by the map_when_managed
  argument.

  XtSetMappedWhenManaged() is a convenience function that is equivalent to (but slightly faster than) calling XtSetValues() to	set  the  new
  value for the XtNmappedWhenManaged resource, and then mapping or unmapping the widget as appropriate.

Usage
  A widget is normally mapped when it is managed, which is usually the desired behavior.  This behavior can be overridden by setting the XtN-
  mappedWhenManaged resource for the widget to False, and then calling XtSetMappedWhenManaged() to map and unmap the  widget  or  by  calling
  XtMapWidget() and XtUnmapWidget() explicitly.

  A  widget that is managed but unmapped will have screen space allocated for it, but will not appear in that space.  A widget that is unman-
  aged will not have screen space allocated for it, and if mapped will likely appear in an undesirable place.

See Also
  XtManageChild(1), XtMapWidget(1), XtUnmapWidget(1).

Xt - Resource Management												  XtSetMappedWhenManaged()