SgVisualDrawingAreaInstallColormap(3X)

     SgVisualDrawingAreaInstallUSgVisualDrawingAreaInstallColormap(3X)



     NAME
          SgVisualDrawingAreaInstallColormap - Install a colormap for
          the VisualDrawingArea widget

     SYNOPSIS
          #include <Sgm/VisualDrawingA.h>

          void SgVisualDrawingAreaInstallColormap (widget)
               Widget    widget;


     VERSION
          This page documents the version of Sgm that accompanies
          Motif 1.2.

     DESCRIPTION
          SgVisualDrawingAreaInstallColormap installs the colormap of
          an SgVisualDrawingArea widget.  Normally it does this by
          adding the widget's window to the WM_COLORMAP_WINDOWS
          property on the shell containing the widget.  This causes
          the window manager to install the colormap whenever the
          shell has focus.  (However, if the shell is marked
          override_redirect, the widget calls XInstallColormap(1X)
          directly in addition changing WM_COLORMAP_WINDOWS.  Some
          window managers will reject such a change).

          There is no need to call SgVisualDrawingAreaInstallColormap
          if the SgNinstallColormap is set, as this resource will
          automatically set the WM_COLORMAP_WINDOWS property.  This
          call is intended for providing more explicit control.

          To uninstall the colormap, call
          SgVisualDrawingAreaUninstallColormap(3X).


          widget Specifies the widget whose colormap is to be
                 installed.


          For a complete definition of VisualDrawingArea and its
          associated resources, see SgVisualDrawingArea(3X).

     RETURN VALUE
          Returns the VisualDrawingArea widget ID.

     RELATED INFORMATION
          SgVisualDrawingArea(3X),
          SgVisualDrawingAreaInstallColormap(3X) .