Lade...
 

CX_WORD_XML::PutText

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)

Stack
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)