DocExchangeDataFiles¶
DocExchangeDataFiles tauscht die Daten eines Dokumentes aus.
-
bool = DocExchangeDataFiles(hDoc, smMatrix)
-
bool = DocExchangeDataFiles(hvPage, smMatrix)
-
bool = DocExchangeDataFiles(hvPage, smMatrix, oPara)
Returnwert
Parameter
-
hDoc
hDoc ist die Zugriffsnummer eines UniPlot-Dokuments. hvPage ist ein Vektor mit Seitenzugriffsnummern.
-
smMatrix
smMatrix ist eine Matrix mit 7 Spalten:
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 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 Daten=>Datenaustausch (Seite):
Wert (String) Bedeutung ""
(leerer String), Austauschen "UNCHANGED"
nicht verändern "SETTOZERO"
auf 0 setzen "SETSTYLEONLY"
nur Stil setzen
-
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
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;
}
History
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 |
Siehe auch
Überblick Dokumente, DocCreate, Daten=>Datenaustausch (Seite), DocGetDataFileList, DocSetDataFileList
id-608347