f$Word: RTF-Datei einfügen

Einfügen eines RTF-Textbausteins an die aktuelle Position.

Der Text kann formatiert im RTF-Format (Rich Text Format) gespeichert sein, ebenso sind aber auch unformatierte „normale" Texte möglich.

Diese RTF-Bausteine können mit der Funktion p$TDV:SMPAPI:S_DATTAB aus der Datenbank extrahiert werden. RTF-Texte können nicht direkt auf einen ePOS Parameter gelesen und als Text eingefügt werden, da in diesem Fall keine Konvertierung von RTF in Word möglich ist.

Auf Wunsch kann die Formatierung des Textes auch über einen speziellen Textbaustein festgelegt werden, der über den Übergabeparameter Baustein übergeben wird (mit Pfadangabe und Dateierweiterung), z.B. wenn der Text eingerückt werden soll. Zur Positionierung des Textes muss der Textbaustein eine Feldfunktion EINFÜGETEXT enthalten. Als Dokument muss in diesem Fall die Feldfunktion DOKVARIABLE mit dem Variablennamen RTFDATEI verwendet werden. Dieses Feld wird dann durch den Text aus der Datenbank ersetzt.

Tipp:

Eine zweite Möglichkeit, eine spezielle Einrückung für den RTF-Text zu erreichen, besteht darin, mittels f$Word: EinfügeTabelle zunächst eine Tabelle einzufügen und durch Einfügen des RTF-Bausteins in diese Tabelle eine Einrückung und einen rechten Rand zu erzwingen. Der mit dieser Funktion eingefügte Text darf selbst keine Dokumentvariablen mehr enthalten.

Syntax:	Status = f$Word('Felder aktualisieren',Sperren,'')
	Argument	Typ	Bedeutung
	Felder aktualisieren	Zeichenkette	Schlüsselwort
	Sperren	Zeichenkette	'' – Die aktualisierten Felder werden gesperrt. '0' - Die aktualisierten Felder werden nicht gesperrt.
	''	Zeichenkette	''
Ergebnis:	Ganzzahl	0: Befehl erfolgreich ausgeführt -1: Kein Dokument aktiv
Beispiel:	Status = f$Word('Felder aktualisieren','','')