.. highlight:: us

.. index:: DocAddDatafiles

.. _DocAddDatafiles:

DocAddDatafiles
===============

.. us.tag DocAddDatafiles DocSet New6700

:ref:`DocAddDatafiles` fügt eine Datei zu einem Satz von Seiten oder einem
kompletten Dokument hinzu.

.. function::  hDoc = DocAddDatafiles(hDoc, rsMainFileID, svFiles)
               hDoc = DocAddDatafiles(hvPages, rsMainFileID, svFiles)
			   hDoc = DocAddDatafiles(hDoc, rsMainFileID, svFiles, oPara)
               hDoc = DocAddDatafiles(hvPages, rsMainFileID, svFiles, oPara)

.. us.return

**Returnwert**

Das Dokument-Handle hDoc wird zurückgegeben. Im Falle eines Fehlers wird 0 zurückgegeben. 

.. us.params

**Parameter**

.. uparam:: hDoc

   *hDoc* ist ein Handle für ein UniPlot-Dokument.
   
.. uparam:: hvPages

   *hvPages* ist ein Vektor mit Seitenhandles.

.. uparam:: rsMainFileID

   *rsMainFileID* ist die Datei, die als Referenz für neue Dateien verwendet
   wird Zusatz.

.. uparam:: svFiles

   *svFiles* ist ein Vektor mit dem Pfad der Datendateien, die importiert und
    dem Dokument auf der Grundlage der *rsMainFileID* hinzugefügt werden.

.. 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**

::

	hDoc = AppGetActiveDocument()
	svFiles = GetOpenFileName("","",1,1) 
	rsMainFileID = 1 //Select the file to copy
	if (hDoc == 0){
		MessageBoxError("No open template")
		return;
	} else {
		hDoc = DocAddDatafiles(hDoc,rsMainFileID,svFiles)
	}

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2025.1
     - Neu

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

:sub:`id-1653200`