.. highlightlang:: us

.. index:: MarkerDialog

.. _markerdialog:

MarkerDialog
============

.. us.tag  MarkerDialog GERMAN DialogBoxes New300

Zeigt ein Dialogfeld zur Konfiguration eines Marker-Symbols an.

.. function::  hMarker = MarkerDialog()
    hMarker = MarkerDialog(hMarker)
    hMarker = MarkerDialog(nStyle, rsSize, rvEdgeColorRGB, rvFillColorRGB, rsEdgeWidth)

.. us.return

**Returnwert**

*hMarker* ist die Zugriffsnummer (Handle) mit der auf den Marker zugegriffen
werden kann. Falls der Marker nicht erzeugt werden kann, ist *hMarker* gleich 0.
Falls der Benuter die Abbrechen-Schaltfläche drückt, ist *hMarker* gleich -1.

.. us.params

**Parameter**

.. uparam:: nStyle

   *nStyle* ist einer der folgenden Werte:

   .. list-table::
      :header-rows: 1

      * - Wert
        - Bedeutung
      * - MS_PLUS (0)
        - Plus-Zeichen.
      * - MS_CROSS (1)
        - Kreuz.
      * - MS_SIMPLESTAR (2)
        - Stern.
      * - MS_CIRCLE (3)
        - Kreis.
      * - MS_RECTANGLE (4)
        - Rechteck.
      * - MS_DIAMOND (5)
        - Raute.
      * - MS_TRIANGLE (6)
        - Dreieck.
      * - MS_TRIANGLE1 (7)
        - Dreieck um 90 Grad gedreht.
      * - MS_TRIANGLE2 (8)
        - Dreieck um 180 Grad gedreht.
      * - MS_TRIANGLE3 (9)
        - Dreieck um 270 Grad gedreht.
      * - MS_HOURGLASS (10)
        - Zwei Dreiecke.
      * - MS_HOURGLASS1 (11)
        - Zwei Dreiecke um 90 Grad gedreht.
      * - MS_STAR (12)
        - Stern.
      * - MS_CIRCLEDOT (13)
        - Kreis mit Punkt
      * - MS_CIRCLEPLUS (14)
        - Kreis mit Plus-Zeichen
      * - MS_CIRCLECROSS (15)
        - Kreis mit Kreuz
      * - MS_RECTDOT (16)
        - Rechteck mit Punkt
      * - MS_RECTPLUS (17)
        - Rechteck mit Plus-Zeichen
      * - MS_RECTCROSS (18)
        - Rechteck mit Kreuz
      * - MS_NULL (19)
        - keine Ausgabe.
      * - MS_DOT (20)
        - kleinster darstellbarer Punkt.

.. uparam:: rsSize

   *rsSize* ist die Größe des Markers in
   Zentimetern (größer 0).

.. uparam:: rvEdgeColorRGB

   *rvEdgeColorRGB* ein Vektor mit drei Elementen, der die Kantenfarbe der Marker
   angibt:

   .. list-table::
      :header-rows: 1

      * - Wert
        - Bedeutung
      * - rvEdgeColorRGB[1]
        - Rotanteil der Farbe im Bereich 0 bis 255
      * - rvEdgeColorRGB[2]
        - Grünanteil der Farbe im Bereich 0 bis 255
      * - rvEdgeColorRGB[3]
        - Blauanteil der Farbe im Bereich 0 bis 255

.. uparam:: rvFillColorRGB

   *rvFillColorRGB* ein Vektor mit drei Elementen, der bei den ausgefüllten
   Markern die Füllfarbe angibt:

   .. list-table::
      :header-rows: 1

      * - Wert
        - Bedeutung
      * - rvFillColorRGB[1]
        - Rotanteil der Farbe im Bereich 0 bis 255
      * - rvFillColorRGB[2]
        - Grünanteil der Farbe im Bereich 0 bis 255
      * - rvFillColorRGB[3]
        - Blauanteil der Farbe im Bereich 0 bis 255

.. uparam:: rsEdgeWidth

   *rsEdgeWidth* ist die Kantenbreite des Markers in 0.1 Millimetern.

.. seealso::
   :ref:`uberblick-marker`,
   :ref:`MarkerCreate`,
   :ref:`MarkerDestroy`,
   :ref:`XYSetMarker`,
   :ref:`XYZSetMarker`

:sub:`id-1028881`