.. highlightlang:: us .. index:: auto_ReplaceTextFromNCFile .. _auto_replacetextfromncfile: auto_ReplaceTextFromNCFile ========================== .. us.tag auto_ReplaceTextFromNCFile GERMAN :ref:`auto_ReplaceTextFromNCFile` sucht in der angegebenen Seite nach in Dollar-Zeichen eingeschlossenen Texten und ersetzt die Texte durch Attribut-Werte aus der angegebenen netCDF (:file:`.NC`) Datei. Die netCDF-Datei wird mit der Funktion :ref:`auto_ImportData` erzeugt. .. function:: nReplaced = auto_ReplaceTextFromNCFile(hPage, ssNCFileName) nReplaced = auto_ReplaceTextFromNCFile(hPage, ssNCFileName, bEdit) nReplaced = auto_ReplaceTextFromNCFile(hPage, ncid) nReplaced = auto_ReplaceTextFromNCFile(hPage, ncid, bEdit) .. us.return **Returnwert** *nReplaced* ist die Anzahl der ersetzten Texte. Wurden keine Texte ersetzt oder ist ein Fehler aufgetreten, wird der Wert 0 zurückgeliefert. .. us.params **Parameter** .. uparam:: hPage *hPage* ist die Zugriffsnummer einer Dokumentseite. *hPage* wird von der Funktion :ref:`auto_LoadTemplate` zurück geliefert. .. uparam:: ssNCFileName *ssNCFileName* ist der vollständige Dateiname der netCDF-Datei. Die Funktion :ref:`auto_ImportData` gibt den NC-Dateinamen für die angegebene Datendatei zurück. .. uparam:: ncid *ncid* ist die id einer NC2-Datei. .. uparam:: 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). .. us.comment **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: :ref:`text-placeholder`. .. us.example **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(); } .. seealso:: :ref:`uberblick-automatisierung-der-diagrammerstellung`, :ref:`auto_ReplaceText`, :ref:`auto_ReplaceTextDialog`, :ref:`auto_ImportData` :sub:`id-424919`