Lade...
 

CX_WORD_XML::PutIntoFirstHeader

CX_WORD_XML::PutIntoFirstHeader

Beschreibung:

Dieser Aufruf schreibt den Inhalt des übergebenen Word-Dokuments in die Kopfzeile der ersten Seite. Der Aufruf verhält sich wie folgt:

  • Zieldokument hat keine* Kopfzeile für die erste Seite:

    Es wird eine Kopfzeile für die erste Seite angelegt, die nur aus Inhalt des übergebenen Dokuments besteht.

  • Zieldokument hat eine Kopfzeile für die erste Seite:

    Der Inhalt des übergeben Dokuments wird an den Inhalt der Kopfzeile für die erste Seite angehängt

*= Unter diesen Punkt fällt auch der Fall, dass es eine Kopfzeile für alle Seiten gibt (also auch für die erste), die für alle Seiten gleich ist. Der Inhalt dieser Kopfzeile wird nicht beim Erstellen der Kopfzeile für die erste Seite berücksichtigt.

Ü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 PutIntoFirstHeader verwendet werden.

PutIntoFirstHeader 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.

PutIntoFirstHeader 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)
"Auf dieser Seite steht keine Kopfzeile mehr" target Call(PutText)
"Kopfzeile des Zieldokuments" header Call(PutText) //Wird nach Call(PutIntoFirstHeader) in der Kopfzeile stehen

header target Call(PutIntoFirstHeader)
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(PutIntoFirstHeader)