.. highlightlang:: us

.. index:: GetColorDialog

.. _getcolordialog:

GetColorDialog
==============

.. us.tag  GetColorDialog NOTREADYGERMAN DialogBoxes New300

:ref:`GetColorDialog` zeigt einen Dialog zur Auswahl einer Farbe.

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

.. us.return

**Returnwert**

*rvColorRGB* Vektor mit den 3 Farbwerten oder der Wert 0, falls die
Abbrechen-Schaltfläche gewählt wurde.

.. us.params

**Parameter**

.. uparam:: rvColorRGBInit

   *rvColorRGB* Startfarbe.

.. us.comment

**Kommentar**

Die eingestellten Benutzerfarben werden in der Registrierdatenbank gespeichert.
Die Farben können über die Funktionen ``GetProfileInt("settings", "custcolor0")``
bis ``GetProfileInt("settings", "custcolor15")`` gelesen werden. Die in der
Registrierdatenbank gespeicherten Werte können mit
``Color_COLORREF_to_RGB(rsColor)`` in einen Vektor umgewandelt werden.

Mit der Funktion UserColorExport(ssFileName) können Sie die 16 
Farben in einer Datei speichern. Mit UserColorImport(ssFileName)
können Sie die Farben wieder einlesen. Der Parameter ssFileName ist der
vollständige Name einer Datei, z. B. ``d:/mycolor.ini``. Die Funktionen geben 
Sie im Kommandofenster ein.

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

:sub:`id-435871`