p$TDV:Allg:ParText
p$TDV:Allg:ParText
Ersetzen aller in einem parametrischen Text verwendeten Parameter. Ein parametrischer Text ist ein ganz normaler Text, der aber noch Platzhalter für Parameterwerte enthält. Die Parameter werden dabei analog zur Funktionalität der Textgenerierung durch das Zeichen „@" eingeschlossen.
Beispiel: | ’Der Preis für @Anzahl@ Stück beträgt @Preis@ Euro’ |
Zusätzlich kann bei jedem Parameter noch eine Formatierung angegeben werden. Im Standardfall wird die Formatanweisung aus der Parametertabelle übernommen. Besonderheit: bei Zahlparametern wird die in der PT angegebene Stellenanzahl berücksichtigt, um damit eine rechtsbündige Ausgabe zu erreichen.
Es ist jedoch auch möglich, spezielle Formate anzugeben: Bei Zeichenketten ist die Angabe von Teiltexten möglich. Die Syntax entspricht dabei den Teiltexten in ePOS:
text(<startpos>:<endpos>)
Bzw. | text (<startpos>:) |
Ist der aktuelle Text dabei kürzer als der Teiltext angibt, so wird am Ende mit Leerzeichen aufgefüllt.
Numerische Parameter lassen sich analog zur Formatanweisung der Parametertabelle durch das Platzhalterzeichen „#" formatieren, als Dezimaltrenner kann ein Punkt oder ein Komma angegeben werden:
zahl(#####,##)
bzw. | zahl(###.#####) |
bzw. | zahl(###) |
Die Ausgabe von Zahlen erfolgt rechtsbündig.
Bitte beachten:
Damit die Parameterersetzung korrekt durchgeführt werden kann, müssen alle im Formattext verwendeten Parameter global sein!
Syntax: | Text = p$TDV:Allg:ParText( FormatText ) | ||
| Argument | Typ | Bedeutung |
| FormatText | Zeichenkette | Formatanweisung für den zu generierenden Text |
Ergebnis: | Zeichenkette | resultierender Text | |
Beispiel: | Es seien gegeben: Artikel.Name = 'Pumpe' | ||
| Dann ergibt Text = p$TDV:Allg:ParText( 'Bauteil @Artikel.Name@ Nr. @Artikel.Ident(3:)@ (@Artikel.Preis(###,##)@ DM)' ) | ||
| das Ergebnis Text = 'Bauteil Pumpe Nr. 4711 (256,67 DM)' | ||