DocAddDatafiles¶
DocAddDatafiles fügt eine Datei zu einem Satz von Seiten oder einem kompletten Dokument hinzu.
- hDoc = DocAddDatafiles(hDoc, rsMainFileID, svFiles)
- hDoc = DocAddDatafiles(hvPages, rsMainFileID, svFiles)
- hDoc = DocAddDatafiles(hDoc, rsMainFileID, svFiles, oPara)
- hDoc = DocAddDatafiles(hvPages, rsMainFileID, svFiles, oPara)
Returnwert
Das Dokument-Handle hDoc wird zurückgegeben. Im Falle eines Fehlers wird 0 zurückgegeben.
Parameter
- hDoc
hDoc ist ein Handle für ein UniPlot-Dokument.
- hvPages
hvPages ist ein Vektor mit Seitenhandles.
- rsMainFileID
rsMainFileID ist die Datei, die als Referenz für neue Dateien verwendet wird Zusatz.
- svFiles
- svFiles ist ein Vektor mit dem Pfad der Datendateien, die importiert und
dem Dokument auf der Grundlage der rsMainFileID hinzugefügt werden.
- oPara
oPara ist ein Objekt, das mit 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.
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.
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)
}
History
Version |
Beschreibung |
---|---|
R2025.1 |
Neu |
Siehe auch
Überblick Dokumente, DocCreate, DocExchangeDataFiles, Daten=>Datenaustausch (Seite), DocGetDataFileList, DocSetDataFileList
id-1653200