.. highlightlang:: us

.. index:: DocGetDataFileList

.. _docgetdatafilelist:

DocGetDataFileList
==================

.. us.tag  DocGetDataFileList GERMAN DocGet New5110 Changed5705

:ref:`DocGetDataFileList` liefert die im Dokument gespeicherte Liste der
Datendateien bzw. die in den angegebenen Seiten verwendete Liste der
Datendateien.

.. function::  smMatrix = DocGetDataFileList(hDoc)
    smMatrix = DocGetDataFileList(hvPage)
    smMatrix = DocGetDataFileList(hDoc, bUpdate)

.. us.return

**Returnwert**

*smMatrix* ist eine Matrix mit 6 Spalten:

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

   * - Spalte
     - Alias
     - Bedeutung
   * - 1
     - DS_FILE_ORIGIN
     - Name der Originaldatei. Bei Exceldateien kann der  Tabellenname in eckigen
       Klammern angehängt werden.
   * - 2
     - DS_FILE_NCNAME
     - Name der NC-Datei
   * - 3
     - DS_FILE_ACTION
     - Aktionstring: Einer der folgenden Werte: ``UNCHANGED``, ``SETTOZERO``,
       ``SETSTYLEONLY`` oder ein leerer String ``""`` für Austauschen
   * - 4
     - DS_FILE_STYLEPROPS
     - Stilattribute von 2D-Datensätzen, siehe :ref:`XYSetProps`
   * - 5
     - DS_FILE_STYLEPROPS3D
     - Stilattribute von 3D-Datensätzen, siehe :ref:`XYZSetProps`
   * - 6
     - DS_FILE_COMMENT
     - Kommentar-Text
   * - 6
     - DS_FILE_COMMENT
     - Kommentar-Text
   * - 7
     - DS_FILE_RECORDFILTER
     - Rekord-Filter: Siehe :ref:`auto_setfilter`

Falls die Liste leer ist, enthält *smMatrix* einen leeres Stringelement.

.. us.params

**Parameter**

.. uparam:: hDoc

   *hDoc* ist die Zugriffsnummer eines UniPlot-Dokuments. Falls die Funktion mit
   *hDoc* aufgerufen wird, liefert die Funktion die Dateinamensliste für alle
   Seiten des Dokumentes.

.. uparam:: hvPage

   *hvPage* ist ein Vektor mit Zugriffsnummern von Seiten eines
   UniPlot-Dokuments. Die zurück gegebene Liste enthält nur die Datendatei-Namen
   die in den angegebenen Seiten verwendet werden. 

.. uparam:: bUpdate

   Wenn *bUpdate* gleich TRUE (1) ist, wird die Datenquelle aus allen Datensätzen
   neu geladen. Defaultwert ist TRUE (1).

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2015.5
     - Neue Spalte DS_FILE_RECORDFILTER zugefügt
   * - 5.11.0
     - Neu

.. seealso::
   :ref:`uberblick-dokumente`,
   :ref:`DocCreate`,
   :ref:`datendatenaustausch-(seite)`,
   :ref:`DocSetDataFileList`,
   :ref:`DocExchangeDataFiles`

:sub:`id-360753`