xtmapwidget(3xt) [ultrix man page]

XtMapWidget(3Xt)						     MIT X11R4							  XtMapWidget(3Xt)

Name
       XtMapWidget, XtSetMappedWhenManaged, XtUnmapWidget - map and unmap widgets

Syntax
       XtMapWidget(w)
	  Widget w;

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

       XtUnmapWidget(w)
	  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 maps the window.  If the widget is realized and managed
       and if the new value of map_when_managed is it unmaps the window.  is a convenience function that is equivalent to (but slightly faster
       than) calling and setting the new value for the mappedWhenManaged resource.  As an alternative to using to control mapping, a client may
       set mapped_when_managed to and use and explicitly.

See Also
       XtManageChildren(3Xt)
       X Window System Toolkit: The Complete Programmer's Guide and Specification, Paul J. Asente and Ralph Swick
       X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys

																  XtMapWidget(3Xt)

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()