CX_WORD_XML::PutText
Beschreibung:
Schreibt die auf dem Stack übergebene Zeichenkette als Absatz ans Ende des Dokuments. Sollte das Dokument mit einem leeren Absatz abschließen, wie es bei einem leeren Dokument zum Beispiel der Fall ist, dann
wird der Text in diesen Absatz reingeschrieben, anstatt einen neuen anzuhängen. Dabei werden die Formatierungsangaben des Absatzes nicht übernommen. Sollte die Zeichenkette aus mehreren Zeilen bestehen ("\n" enthalten), dann werden die Zeilen als einzelne Absätze in das Dokument eingefügt.
Mit PutText lässt sich nur in den Dokumentbereich schreiben. Kopfzeile und Fußzeile können damit nicht bearbeitet werden.
Das PutText verädert den transitiven Bereich des Dokuments. Damit Änderungen in der Datenbank übernommen werden, muss SaveXMLString aufgerufen werden.
Vor DLL-Version 4.5.2.155571 hat PutText die Zeilen in den letzten Absatz reingeschrieben und durch kleine Umbrüche getrennt(Shift+Enter) und
die letzte Zeile wiederum mit einem kleinen Umbruch abgeschlossen.
Code-Beispiel:
Var(xml)
//XML Dokument initialisieren
CreateTransObject(CX_WORD_XML) -> xml
xml Call(EmptyDocument)
//Inhalt einfügen
"1. Absatz" xml Call(PutText)
"2. Absatz" xml Call(PutText)
"" xml Call(PutText) //leeren Absatz einfügen, der von der nächsten Operation überschrieben wird
"3. Absatz" xml Call(PutText)
"\n" xml Call(PutText) //Zwei leere Absätze einfügen, dadurch bleibt ein leerer Absatz nach dem nächsten Einfügen erhalten
"5. Absatz" xml Call(PutText)
xml Call(AsCOM) Call(CX_Open)
//XML Dokument initialisieren
CreateTransObject(CX_WORD_XML) -> xml
xml Call(EmptyDocument)
//Inhalt einfügen
"1. Absatz" xml Call(PutText)
"2. Absatz" xml Call(PutText)
"" xml Call(PutText) //leeren Absatz einfügen, der von der nächsten Operation überschrieben wird
"3. Absatz" xml Call(PutText)
"\n" xml Call(PutText) //Zwei leere Absätze einfügen, dadurch bleibt ein leerer Absatz nach dem nächsten Einfügen erhalten
"5. Absatz" xml Call(PutText)
xml Call(AsCOM) Call(CX_Open)
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_WORD_XML | Zieldokument für diese Operation |
Top-1 | STRING | Einzufügender Text | |
Stack(Out) | Top |
Funktionsaufruf: Call(PutText)