SgVisualDrawingAreaInstallColormap(3X)

NAME
     SgVisualDrawingAreaInstallColormap  -- Install  a  colormap for the Visual-
     DrawingArea 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  SgVisual-
     DrawingArea 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_WIN-
     DOWS.  Some window managers will reject such a change).

     There  is  no need to call SgVisualDrawingAreaInstallColormap if the SgNin-
     stallColormap is set, as this resource will automatically set  the  WM_COL-
     ORMAP_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  re-
     sources, see SgVisualDrawingArea(3X).

RETURN VALUE
     Returns the VisualDrawingArea widget ID.

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

                                          SgVisualDrawingAreaInstallColormap(3X)