auto_ReplaceTextFromNCFile¶
auto_ReplaceTextFromNCFile sucht in der angegebenen Seite nach in
Dollar-Zeichen eingeschlossenen Texten und ersetzt die Texte durch Attribut-Werte
aus der angegebenen netCDF (.NC) Datei. Die netCDF-Datei wird mit der
Funktion auto_ImportData erzeugt.
-
nReplaced = auto_ReplaceTextFromNCFile(hPage, ssNCFileName) -
nReplaced = auto_ReplaceTextFromNCFile(hPage, ssNCFileName, bEdit) -
nReplaced = auto_ReplaceTextFromNCFile(hPage, ncid) -
nReplaced = auto_ReplaceTextFromNCFile(hPage, ncid, bEdit)
Returnwert
nReplaced ist die Anzahl der ersetzten Texte. Wurden keine Texte ersetzt oder ist ein Fehler aufgetreten, wird der Wert 0 zurückgeliefert.
Parameter
-
hPage hPage ist die Zugriffsnummer einer Dokumentseite. hPage wird von der Funktion auto_LoadTemplate zurück geliefert.
-
ssNCFileName ssNCFileName ist der vollständige Dateiname der netCDF-Datei. Die Funktion auto_ImportData gibt den NC-Dateinamen für die angegebene Datendatei zurück.
-
ncid ncid ist die id einer NC2-Datei.
-
bEdit Falls bEdit TRUE (1) ist, wird der Platzhalter in den Objekt-Namen kopiert. In diesem Fall kann der Text über einen Doppelklick editiert werden. Default Wert ist FALSE (0).
Kommentar
Die Platzhalter in der IPW-Datei müssen in Dollar-Zeichen eingeschlossen sein.
Für die Attributnamen muss die Groß- und Kleinschreibung beachtet werden.
Zahlenwerte werden in Texte umgewandelt. Handelt es sich um einen Vektor, so
werden die einzelnen Elemente durch ein Komma, gefolgt von einem Leerzeichen
getrennt. Beispiel: "1, 2". Die Platzhalter werden nicht in den Namen des
Textobjekts kopiert. Beispiel: $Origin$. Der Text innerhalb der $-Zeichen
muss mit einem Text in den globalen Attributen der angegebenen NC-Datei
übereinstimmen.
Um auf die Attribute einer bestimmten Variablen zuzugreifen, wird der Name
der Variablen durch einen Punkt vom Attributnamen getrennt. Beispiel:
$Mom.long_name$.
Siehe auch: Text-Platzhalter.
Beispiel
auto_AddToUI("Examples", "Example 1: Map", "RS_Example1");
def RS_Example1()
{
auto_SetFileNameDialogInit("*.xls", GetRootDirectory() + "samples/");
svFile = auto_GetFileNameDialog(1);
if (svFile[1] == "DLG_CANCEL") {
return;
}
hPage = auto_LoadTemplate("Example.ipw");
svFile[1] = auto_ImportData(svFile[1]);
auto_LoadDataset("Diagramm 1", "N", "EWGMOM", "EWGLST");
auto_LoadDataset("Diagramm 2", "N", "EWGMOM", "BEEWG");
auto_ReplaceTextFromNCFile(hPage, svFile[1]);
auto_ScaleAxes();
auto_UpdatePage();
}
Siehe auch
Überblick Automatisierung der Diagrammerstellung, auto_ReplaceText, auto_ReplaceTextDialog, auto_ImportData
id-424919