.. highlightlang:: us

.. _xysetmarkerfrequence:

XYSetMarkerFrequence
====================

.. index:: XYSetMarkerFrequence

.. us.tag  XYSetMarkerFrequence NOTREDYGERMAN XYSet Changed5603

:ref:`XYSetMarkerFrequence` legt fest, in welchem Punktabstand
für die Datenpunkte ein Marker ausgegeben wird.

.. function::  bool = XYSetMarkerFrequence(hData, nFreq)

.. 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:`XYCreate` oder :ref:`TYCreate` erzeugt wurde.

.. uparam:: nFreq

   Wenn *nFreq* gleich 1 ist, wird für jeden Datenpunkt ein Marker ausgegeben.
   Für den Wert 2 wird wird jeder zweite Punkt durch einen Marker markiert.

   Wenn *nFreq* größer als 1e6 ist, gibt die Differenz zwischen *nFreq* und 1e6
   die Anzahl der Marker an, die auf den im Diagramm angezeigten Bereich verteilt
   werden. Der Datensatz muss dazu monoton aufsteigend sortiert sein. Beispiel:
   Bei einem Wert von 1000020 werden 20 Marker ausgegeben.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2014.3
     - Neue Bedeutung des Parameters *nFreq*. 

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYGetMarker`,
   :ref:`XYGetMarkerFrequence`,
   :ref:`XYShowMarker`,
   :ref:`MarkerCreate`,
   :ref:`XYCreate`

:sub:`id-447355`