.. highlightlang:: us .. index:: auto_ReplaceText .. _auto_replacetext: auto_ReplaceText ================ .. us.tag auto_ReplaceText NOTREADYGERMAN :ref:`auto_ReplaceText` ersetzt vorhandene Texte in der Vorlage durch neue Texte. Die Texte können sich in Textobjekten und Achsentiteln befinden. .. function:: hText = auto_ReplaceText(ssFind, ssReplace) hText = auto_ReplaceText(ssFind, ssReplace, bEdit) .. us.return **Returnwert** *hText* ist die Zugriffsnummer (Handle) des Textobjekts, in dem der Text *ssTextOld* gefunden wurde. Falls *ssTextOld* nicht gefunden wurde, liefert die Funktion den Wert 0. Falls der Suchtext *ssTextOld* mehrfach vorhanden ist, liefert die Funktion die Zugriffsnummer des zuletzt gefundenen TextObjekts. .. us.params **Parameter** .. uparam:: ssFind *ssFind* ist der Text der ersetzt werden soll. Der Text sollte in ``$``-Zeichen eingeschlossen sein, z. B. ``"$Bearbeiter$"``. .. uparam:: ssReplace *ssReplace* ist der neue Text. .. uparam:: rsReplace *rsReplace* ist eine reelle Zahl. Die Zahl wird in einen String umgewandelt. .. uparam:: bEdit Falls *bEdit* TRUE (1) ist, wird der Platzhalter beim Text-Objekt aus dem Text-Feld in das Name-Feld kopiert. Falls *bEdit* FALSE (0) ist, wird der Platzhalter beim Text-Objekt aus dem Text-Feld nicht in das Name-Feld kopiert. Default-Wert is FALSE. Wenn der Platzhalter im Namen steht, kann der Dialog :ref:`objekt-bearbeitenplatzhalter-dialog` zum Bearbeiten des Textes verwendet werden. .. us.comment **Kommentar** Wenn man in der Vorlage einen Platzhalter in den Text einfügt, muss das Namesfeld des Textobjektes leer sein. Platzhalter im Namesfeld habe eine höhere Priorität als Platzhalter im Text. Wenn das Textfeld mehrere Paltzhalter enthält, wird der Text automatisch im Namesfeld gespeichert. .. us.example **Beispiel** :: auto_LoadTemplate(GetRootDirectory() + "/template/tpl1.ipw") auto_ReplaceText("$OPERATOR$", "Mr. Miller") auto_ReplaceText("$GREEKLETTERS$", "\a\b\c\A\B\C") auto_ReplaceText("$TWOLINES$", "Zeile 1\r\nZeile2") rsValue = 123.23 auto_ReplaceText("$Value$", sprintf("%.2lf", rsValue)) auto_UpdatePage() .. seealso:: :ref:`uberblick-automatisierung-der-diagrammerstellung`, :ref:`auto_ReplaceTextDialog`, :ref:`objekt-bearbeitenplatzhalter-dialog`, :ref:`sprintf` :sub:`id-1071328`