Lade...
 

CX_WORD_XML::PutIntoHeader

CX_WORD_XML::PutIntoHeader

Beschreibung:

Dieser Aufruf schreibt den Inhalt des übergebenen Word-Dokuments jede Kopfzeile des Zieldokuments. Der Aufruf verhält sich dabei wie folgt:

  • Zieldokument hat keine Kopfzeile:

    Es wird eine Kopfzeile für alle Seiten angelegt, welche aus dem Inhalt des übergebenen Dokuments besteht.

  • Zieldokument hat eine Kopfzeile für alle Seiten:

    Der Inhalt des übergebenen Dokuments wird an diese Kopfzeile angehängt. (Verhält sich wie PutFormattedText)

  • Zieldokument hat für einige Seiten verschiedene Kopfzeilen:

    Der Inhalt des übergebenen Dokuments wird an jede dieser Kopfzeilen angehängt.

  • ZielDokument hat nur für einige Seiten eine Kopfzeile:

    Für alle Seiten ohne Kopfzeile wird eine neue Kopfzeile angelegt, die nur aus dem Inhalt der übergebenen Dokuments besteht und an alle restlichen Kopfzeilen wird der Inhalt des übergebenen Dokuments angehängt.

Über diesen Aufruf können auch Wasserzeichen in Dokumente eingefügt werden. Wasserzeichen sind in Word nichts weiter, als WordArt Schriftzüge, die sich in der Kopfzeile befinden. Somit muss, um ein Wasserzeichen in ein Dokument einzufügen, nur ein Dokument, welches aus einem WordArt besteht als Parameter für PutIntoHeader verwendet werden.

PutIntoHeader verändert nur den transienten Bereich des CX_WORD_XML Objekts. Um die Änderungen in einem persistenten Objekt zu übernehmen, muss Call(SaveXMLString) verwendet werden.

PutIntoHeader akzeptiert als Parameter alle Objekte, die sich in ein CX_WORD_XML konvertieren lassen. Dabei wird die Konvertierung wie folgt durchgeführt:

Dieser Aufruf wird ab Dll-Version 4.5.2.158947 unterstützt

Code-Beispiel:
Var(target, header)
CreateTransObject(CX_WORD_XML) -> target
CreateTransObject(CX_WORD_XML) -> header
target Call(EmptyDocument)
header Call(EmptyDocument)

"Text des Zieldokuments" target Call(PutText)
target Call(InsertBreak)
"Auch auf dieser Seite steht eine Kopfzeile" target Call(PutText)
"Kopfzeile des Zieldokuments" header Call(PutText) //Wird nach Call(PutIntoHeader) in der Kopfzeile stehen

header target Call(PutIntoHeader)
target Call(AsCOM) Call(CX_Open)

Stack
Stack Position Objekttyp Kurzbeschreibung
Stack(In) Top CX_WORD_XML Das Dokument, in dessen Kopfzeile geschrieben werden soll
Stack(Out) Top CX_WORD_XML |
CX_MULTIPLE_WORD_XML |
CX_COM_OBJECT |
CX_MULTIPLE_COM_OBJECT 		Das Dokument, welches in die Kopfzeile geschrieben werden soll.

Funktionsaufruf: Call(PutIntoHeader)