.. highlightlang:: us

.. index:: MarkerCreate

.. _markercreate:

MarkerCreate
============

.. us.tag  MarkerCreate GERMAN Changed427

:ref:`MarkerCreate` erzeugt einen Marker. Marker werden für 2D- oder
3D-Streudiagramme verwendet.

.. function::  hMarker = MarkerCreate()
    hMarker = MarkerCreate(hMarkerOther)
    hMarker = MarkerCreate(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.

.. us.params

**Parameter**

.. uparam:: hMarkerOther

   *hMarkerOther*

.. 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.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 4.2.7
     - Die Funktion kann auch als Kopier-Konstruktor aufgerufen werden.

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

:sub:`id-751959`