WP INSERT DOCUMENT

Home

4D v16

WP INSERT DOCUMENT


WP INSERT DOCUMENT ( AusschnittObj ; wpDok ; Modus {; UpdateAusschnitt} )

Parameter	Typ	Beschreibung
AusschnittObj	Objekt	4D Write Pro Ausschnitt
wpDok	Objekt	4D Write Pro Dokument
Modus	Lange Ganzzahl	Einfügemodus
UpdateAusschnitt	Lange Ganzzahl	Modus für Update Ausschnitt

Beschreibung

Der Befehl WP INSERT DOCUMENT fügt das Dokument wpDok im Bereich AusschnittObj ein, gemäß den Parametern Modus zum Einfügen und UpdateAusschnitt.
In AusschnittObj übergeben Sie ein gültiges standardmäßiges 4D Write Pro Objekt für den Ausschnitt. Es ist ein Teil des 4D Write Pro Dokuments und lässt sich über die Befehle , WP Get bookmark range oder WP Get range erstellen.

Das eingefügte Objekt wpDok kann ein beliebiges Objekt 4D Write Pro Dokument sein, erstellt mit dem Befehl WP New oder WP Import document. Nur die Unterelemente des Hauptteils werden eingefügt (Abschnitte und Bookmarks im Zielbereich werden beibehalten). Außerdem werden die Elemente kopiert, so dass sich wpDok mehrere Male verwenden lässt.

Im Parameter Modus übergeben Sie eine oder mehrere miteinander kombinierte Konstanten unter dem Thema 4D Write Pro Konstanten für den Einfügemodus im Zielbereich AusschnittObj:

Konstante	Typ	Wert	Kommentar
wk append	Lange Ganzzahl	2	Fügt Inhalt am Ende des Ausschnitts ein
wk prepend	Lange Ganzzahl	1	Fügt Inhalt am Anfang des Ausschnitts ein
wk replace	Lange Ganzzahl	0	Ersetzt Inhalt des Ausschnitts

Sie können eine der vorigen Konstanten mit den folgenden Einfügeoptionen kombinieren:

Konstante	Typ	Wert	Kommentar
wk freeze expressions	Lange Ganzzahl	64	Friert Ausdrücke beim Einfügen ein
wk inherit style from paragraph	Lange Ganzzahl	32	Eingefügter Inhalt erbt Schriftstil vom Standard Schriftstil des Absatzes
wk keep paragraph styles	Lange Ganzzahl	128	Stilarten des Zielabsatzes beibehalten

Im optionalen Parameter UpdateAuschnitt können Sie eine der folgenden Konstanten zum Einfügen in den aktualisierten Ausschnitt übergeben:

Konstante	Typ	Wert	Kommentar
wk exclude from range	Lange Ganzzahl	1	Eingefügter Inhalt wird nicht in aktualisierten Ausschnitt eingefügt
wk include in range	Lange Ganzzahl	0	Eingefügter Inhalt wird in aktualisierten Ausschnitt eingefügt (Standard)

Standardmäßig, d.h. ohne den Parameter UpdateAuschnitt wird der eingefügte Inhalt in den Zielbereich übernommen.

Beispiel 1

Den Inhalt eines Dokuments mit einen anderen ersetzen:

 $tempRange:=WP Get selection(WPTemplate) //Auswahl des Benutzers im Dokument WPTemplate finden

 $doctoCopy:=WP New($tempRange) //Ein neues Dokument aus der Vorlage WPTemplate erstellen

 WP INSERT DOCUMENT(WPDoc;$doctoCopy;wk replace) //Inhalt von WPDoc mit Inhalt des neuen Dokuments ersetzen

Beispiel 2

Sie haben eine Vorlage mit verschiedenen vorformatierten Teilen definiert, jeder Teil wird als Lesezeichen gespeichert. Beim Erstellen des endgültigen Dokuments aus der Vorlage können Sie jedes Lesezeichen als ein neues Dokument entnehmen und in das endgültige Dokument einfügen.

 ARRAY TEXT($_BookmarkNames;0)

 WP GET BOOKMARKS([TEMPLATES]WP;$_BookmarkNames) //Die Lesezeichen von der Vorlage erhalten

 $targetRange:=WP New //Ein leeres Dokument erstellen (wird das endgültige Dokument)

 

 $p:=Find in array($_BookmarkNames;"Main_Header") //Den Hauptkopfteil verwalten

 If($p>0)

    $Range:=WP Get bookmark range(WParea;$_BookmarkNames{$p}) //Den Ausschnitt auswählen

    $RangeDoc:=WP New($Range) //Ein neues Dokument aus dem Ausschnitt erstellen

    WP INSERT DOCUMENT($targetRange;$RangeDoc;wk append+wk freeze expressions) //wk append=nach Ersetzen ist $targetRange gleich dem Ende des ersetzten Textes

 End if

Siehe auch

WP INSERT BREAK
WP INSERT PICTURE
WP New