.. highlightlang:: us

.. index:: DocExchangeDataFiles

.. _docexchangedatafiles:

DocExchangeDataFiles
====================

.. us.tag  DocExchangeDataFiles GERMAN DocSet New5110 Changed5156 Changed5403

:ref:`DocExchangeDataFiles` tauscht die Daten eines Dokumentes aus.

.. function::  bool = DocExchangeDataFiles(hDoc, smMatrix)
               bool = DocExchangeDataFiles(hvPage, smMatrix)
               bool = DocExchangeDataFiles(hvPage, smMatrix, oPara)

.. us.return

**Returnwert**

.. us.params

**Parameter**

.. uparam:: hDoc

   *hDoc* ist die Zugriffsnummer eines UniPlot-Dokuments. *hvPage* ist ein Vektor
   mit Seitenzugriffsnummern. 

.. uparam:: smMatrix

   *smMatrix* ist eine Matrix mit 7 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
        - Aktionsstring.
      * - 4
        - DS_FILE_STYLEPROPS
        - Stilattribute von 2D-Datensätzen.
      * - 5
        - DS_FILE_STYLEPROPS3D
        - Stilattribute von 3D-Datensätzen.
      * - 6
        - DS_FILE_COMMENT
        - Kommentar.
      * - 7
        - DS_FILE_RECORDFILTER
        - Rekord-Filter: Siehe :ref:`auto_setfilter`

   Die zu ersetzenden Datendateinamen werden in in die Spalte ``DS_FILE_ORIGIN``
   eingetragen. Auch neue NC-Dateien werden in diese Spalte eingetragen.
   
   Gültige Werte für den Aktionsstring (siehe Beispiel und 
   :ref:`datendatenaustausch-(seite)`:

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

      * - Wert (String)
        - Bedeutung
      * - ``""``
        - (leerer String), Austauschen
      * - ``"UNCHANGED"``
        - nicht verändern
      * - ``"SETTOZERO"``
        - auf 0 setzen
      * - ``"SETSTYLEONLY"``
        - nur Stil setzen

.. uparam:: oPara

   *oPara* ist ein Objekt, das mit :ref:`obj_create` erzeugt wurde. Mit Hilfe des
   Objektes können Parameter an die Funktion übergeben werden. Werden die Werte
   nicht vorgegeben, verwendet die Funktion die letzten interaktiv ausgewählten
   Werte.

   .. list-table::
      :header-rows: 1
  
      * - Element
        - Bedeutung
      * - bUpdatePlaceholder
        - Wenn TRUE (1): Dollar-Platzhalter aktualisieren.
      * - nRecordFilter
        - Wert=1: Verwende Rekord Filter aus Datendatei, Wert=2: Verwende 
          Rekord-Filter aus Datensatz (Kurve), Wert=3: Keinen Rekord-Filter 
          anwenden.
      * - bAutoscale
        - Wenn TRUE (1): Achsen automatisch skalieren.
      * - bResetDatasetScaling
        - Wenn TRUE (1): Skalierfaktor und Offset auf Defaultwerte 
          setzen (1, 0).
      * - bDisplayChannelReplaceDialog 
        - Falls auf TRUE (1) gesetzt, wird eine Dialogbox angezeigt um fehlde
          Kanäle durch gültige Kanäle zu ersetzen.

.. us.example

**Beispiel**

::

   RegisterCommand("Data", "MyDataExchange", "My Data Exchange");
   UserBar_Add("MyDataExchange");
   def MyDataExchange()
   {
       hDoc = AppGetActiveDocument();
       if (hDoc == 0) {
           MessageBoxError("No active Document");
           return FALSE;
       }
       smF = DocGetDataFileList(hDoc);
       smF[1;DS_FILE_ORIGIN] = "c:/programme/uniplot/samples/TEST4.xls [data]";
       smF[1;DS_FILE_COMMENT] = "This is a comment";
       smF[1;DS_FILE_ACTION] = "";  // Austauschen

       obj = [.];
       obj.nRecordFilter = 1; 
       obj.bAutoscale = TRUE; 

       DocExchangeDataFiles(hDoc, smF, obj);
       PageReplot(DocGetActivePage(hDoc));
       return TRUE;
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2015.5
     - Neue Spalte DS_FILE_RECORDFILTER zugefügt
   * - R2012.3
     - Neuer Parameter **oPara**
   * - 5.15.6
     - Kann alternativ mit der Zugriffsnummer einer oder mehrerer Seiten aufgerufen werden.
   * - 5.11.0
     - Neu

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

:sub:`id-608347`