.. highlightlang:: us

.. _xysetmarkerfrequence:

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

.. index:: XYSetMarkerFrequence

.. us.tag  XYSetMarkerFrequence NOTREDYENGLISH XYSet Changed5603

:ref:`XYSetMarkerFrequence` sets the marker frequency.

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

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise
it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   The handle of a dataset created with :ref:`XYCreate` or
   :ref:`TYCreate`.

.. uparam:: nFreq

   If *nFreq* = 1, all data points will be marked. For a value of 2
   only every second data point will be marked. For a value of 3
   every third data point will be marked, and so on. 

   If *nFreq* is greater than 1e6, the difference between *nFreq* and 1e6
   is the number of markers which will be spread evenly over the visible
   range in the diagram. The datase must be monoton incresing. Example:
   The value 1000020 will display 20 markers.

.. us.history

**History**

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

   * - Version
     - Description
   * - R2014.3
     - Parameter *nFreq* modified. Spread marker evenly.

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`XYGetMarker`,
   :ref:`XYGetMarkerFrequence`,
   :ref:`XYShowMarker`,
   :ref:`MarkerCreate`,
   :ref:`XYCreate`

:sub:`id-447355`