.. highlightlang:: us

.. _xyzsetcolormap:

XYZSetColorMap
==================

.. index:: XYZSetColorMap

.. us.tag  XYZSetColorMap GERMAN XYZSet_iso New5900

:ref:`XYZSetColorMap` setzt den Namen einer Farbliste für
das Füllen der Flächen eines Kontourdiagramms.

.. function::  bool = XYZSetColorMap(hData, ssColorMapName)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war
und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des
   Datensatzes, der mit :ref:`XYZCreate` erzeugt wurde.

.. uparam:: ssColorMapName

   *ssColorMapName* ist der Name eine Frabliste aus der folgenden Liste

   .. image:: S:/uniplot-obj/images/colormaplist.*

.. us.comment

**Kommentar**

Der Aufruf der Funktion :ref:`XYZSetColorMap` schaltet die Verwendung der
Farblist ein. Falls die Füllfarben mit der Funkion :ref:`XYZSetFillColors`
gesetzt werden sollen, muss :ref:`XYZEnableColorMap` aufgerufen werden, um die
Option abzuschalten.

Die Änderung wird erst nach Aufruf der Funktion :ref:`XYZUpdate` aktiv.

.. seealso::
   :ref:`uberblick-xyz-datensatze`,
   :ref:`XYZCreate`,
   :ref:`XYZSetFillColors`,
   :ref:`XYZGetColorMap`,
   :ref:`XYZEnableColorMap`,
   :ref:`XYZSetFill`

:sub:`id-1206591`