.. highlightlang:: us

.. index:: XYZEnableColorMap

.. _XYZEnableColorMap:

XYZEnableColorMap
=================

.. us.tag  XYZEnableColorMap ENGLISH XYZSet_iso New5900

:ref:`XYZEnableColorMap` enables the use of the specified color map
for a contour map or 3D surface map.

.. function::  bool = XYZEnableColorMap(hData, bEnable)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise
it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYZCreate`.

.. uparam:: bEnable

   *bEnable* is TRUE (1) or FALSE (0).

.. us.comment

**Comment**

Changes come into effect after the function :ref:`XYZUpdate` is called.

.. seealso::
   :ref:`overview-xyz-datasets`,
   :ref:`XYZCreate`,
   :ref:`XYZSetFillColors`,
   :ref:`XYZSetColorMap`,
   :ref:`XYZIsColorMapEnabled`,
   :ref:`XYZSetFill`,
   :ref:`ColorScale_GetNames`,
   :ref:`ColorScale_GetColors`

:sub:`id-778749`