.. highlightlang:: us

.. index::  ColorScale_dialog

.. _colorscale_dialog:

ColorScale_dialog
=================

.. us.tag   ColorScale_dialog NOTREADYGERMAN DialogBoxes New5900

:ref:`ColorScale_dialog` zeigt einen Dialog zur Auswahl einer Farbskala.

   .. image:: S:/uniplot-obj/images/Data3DDatasetColorMap-de.*

.. function::  rvColorRGB =  ColorScale_dialog()
               rvColorRGB =  ColorScale_dialog(rvColorRGBInit)

.. us.return

**Returnwert**

*oColor* ist ein Object mit den Elementen *ssColorScaleName* und *rmColor*.
Falls die **Abbrechen**-Schaltfläche im Dialog gewählt wurde, wird die Zahl 0
zurück geliefert.

Das Element *oColor.ssColorScaleName* enthält den Namen der Farbskala.
*oColor.rmColor* ist eine dreispaltige Matrix mit den RGB-Werten der Farbskala.
Die Anzahl der Zeilen der Matrix entspricht dem Parameter *nColor*.

.. us.params

**Parameter**

**Parameters**

.. uparam:: ssColorScale

   *ssColorScale* ist der Name einer Farbskala für die Initialisierung der
   Dialogbox. Wenn ein leerer String übergeben wird, wird die erste Farbskala 
   ausgewählt.

**Parameters**

.. uparam:: nColor

   *nColor* ist die Anzahl der benötigten Farben. Die Farben werden im 
   Element *oColor.rmColor* zurückgegeben. Falls *nColor* gleich 1 ist, werden
   12 Farben angezeigt. Für den Wert 1 wird die letzte Farbe der Farbskala geliefert.
   Es werden maximal 12 Farben für eine Farbskala im Dialogfeld angezeigt. 

Liste der verfügbaren Farbskalierungen:

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

.. seealso::
   :ref:`uberblick-dialogboxen`,
   :ref:`GetColorGradientDialog`,
   :ref:`ColorScale_GetColors`,
   :ref:`ColorScale_GetNames`

:sub:`id-1002797`