.. highlightlang:: us

.. index:: XYSetData

.. _xysetdata:

XYSetData
=========

.. us.tag  XYSetData GERMAN xy.data New400 Changed530 Changed590 Changed5200

:ref:`XYSetData` setzt die XY-Koordinaten eines Datensatzes.

.. function::  bool = XYSetData(hData)
    bool = XYSetData(hData, bExt)
    bool = XYSetData(hData, rvX, rvY)
    bool = XYSetData(hData, rvX, rvY, bExt)
    bool = XYSetData(hData, rvX, rvY, bExt, rvMissingValue)

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

   *rvX* ist ein Vektor mit den X-Koordinaten.

.. uparam:: rvY

   *rvY* ist ein Vektor mit den Y-Koordinaten.

.. uparam:: bExt

   Der Parameter legt fest, ob die Funktion auf die Originaldaten oder die 
   gefilterten Daten zugreift.

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

      * - Wert
        - Beschreibung
      * - -1
        - Falls gefilterte Daten vorhanden sind: Zugriff auf die gefilterten Daten, sonst auf die Originaldaten. Der Defaultwert ist -1.
      * - 0
        - Zugriff auf die Originaldaten.
      * - 1
        - Zugriff auf die gefilterten Daten.

.. uparam:: rvMissingValue

   *rvMissingValue* ist ein Vektor mit einem oder zwei Elementen. Mit dem
   Parameter wird ein ungültige Wert für *rvX* und *rvY* festgelegt. Die 
   ungültigen Werte werden dem Datensatz nicht zugefügt. 
   Falls *rvMissingValue* nur einen Wert enthält, wird der Wert für die 
   x- und die y-Koordinaten verwendet. Der Default-Wert ist 1e10.

.. us.comment

**Kommentar**

Die Anzahl der Elemente der Vektoren *rvX* und *rvY* muss gleich sein.

Ein Aufruf ohne Daten löscht die Daten des Datensatzes.

Beim Laden der Daten werden alle Punkte, deren Werte mit dem Wert in 
*rvMissingValue* übereinstimmen, ignoriert.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.20.0
     - Neuer Parameter *rvMissingValue*.
   * - 5.9.0
     - Aufruf mit 2 Parametern.
   * - 5.3.0
     - Ein Aufruf ohne Daten löscht die Daten des Datensatzes.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYCreate`,
   :ref:`TYCreate`,
   :ref:`XYSetDataType`

:sub:`id-600555`