.. highlightlang:: us

.. index:: XYReload

.. _xyreload:

XYReload
========

.. us.tag  XYReload GERMAN XYSet New590 Changed5200 Changed5400

:ref:`XYReload` lädt Datenpunkte eines Datensatzes. Der Datensatz muss zu einem
Diagramm gehören.

.. function::  	bool = XYReload(hData)
				bool = XYReload(hData, nOptions)
				bool = XYReload(hData, nOptions, ncid)

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

   .. list-table::
      :header-rows: 0

      * - ``XY_RELOAD_UPDATE (0)``
        - Daten, falls erforderlich, neu laden.
      * - ``XY_RELOAD_CLIP (1)``
        - Daten innerhalb des Diagramms neu laden.
      * - ``XY_RELOAD_ALL (2)``
        - Daten komplett laden (alle Punkte der Kanäle).
      * - ``XY_RELOAD_FORCERELOAD (4)``
        - Daten auch dann neu laden, wenn sich weder der Diagrammbereich, noch
          die Datendatei geändert hat. 

.. uparam:: ncid

   *ncid* ist die Zugriffsnummer auf eine zum Lesen geöffnete Datendatei (siehe
   :ref:`nc_open`).

.. us.comment

**Kommentar**

Falls *ncid* nicht angegeben ist, öffnet die Funktion die Datendatei
(:file:`*.nc2`) aus der die Daten des Datensatzes ursprünglich geladen wurden. 
Falls diese Datei nicht vorhanden ist, werden die folgenden beiden Verzeichnisse
durchsucht:

* Pfad in der sich die IPW-Datei befindet.

* Pfad der in :ref:`extras-weitere-optionen` Seite: "Datenimport und Datenbrowser"
  unter "Verzeichnis für Datendateien" angegeben ist.

Falls die Datei nicht gefunden wurde, wird eine Meldung im Ereignis-Fenster 
ausgegeben.

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2012 (5.40.0)
     - Die Funktion lädt je nach Diagrammausschnitt reduzierte oder
       nicht-reduzierte Daten.
   * - 5.20
     - Neue optionale Parameter *nOptions* und *ncid*.
   * - 5.9
     - Neu.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`TYCreate`,
   :ref:`XYCreate`,
   :ref:`overview-data-file-informations-for-datasets`

:sub:`id-1004157`