WP INSERT DOCUMENT

Home

4D v20 R7

WP INSERT DOCUMENT


WP INSERT DOCUMENT ( targetObj ; wpDoc ; mode {; rangeUpdate} )

Parameter	Typ	Beschreibung
targetObj	Objekt	Range oder Element oder 4D Write Pro Dokument
wpDoc	Objekt	4D Write Pro Dokument
mode	Lange Ganzzahl	Einfügemodus
rangeUpdate	Lange Ganzzahl	Update Modus für Range

Beschreibung

Der Befehl WP INSERT DOCUMENT fügt das Dokument wpDoc in targetObj ein, gemäß den Parametern mode zum Einfügen und rangeUpdate.

In targetObj übergeben Sie:

Range
Element (Tabelle / Zeile / Absatz / Haupt- / Kopf- /Fußteil / Bild im Textfluß / Abschnitt / Unterabschnitt / Textfeld) oder
4D Write Pro Dokument.

Das eingefügte Objekt wpDoc 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 (z.B. werden Kopf-, Fußteile, Textfelder und verankerte Bilder nicht eingefügt). Abschnitte und Lesezeichen werden im aktualisierten Range beibehalten. Außerdem werden die Elemente kopiert, so dass wpDoc mehrere Male verwendbar ist.

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

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

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 keep paragraph styles	Lange Ganzzahl	128	Wenden Sie Ziel-Absatzstile an. Bei der Operation wk append fügen Sie den Inhalt ohne anfänglichen Absatzumbruch ein.

Ist targetObj ein Range, können Sie im optionalen Parameter rangeUpdate eine der folgenden Konstanten für den Einfügemodus übergeben:

Konstante	Typ	Wert	Kommentar
wk exclude from range	Lange Ganzzahl	1	Eingefügter Inhalt ist nicht im aktualisierten Range enthalten
wk include in range	Lange Ganzzahl	0	Eingefügter Inhalt ist im aktualisierten Range enthalten (Standard)

Ohne den Parameter rangeUpdate wird der eingefügte Inhalt in den aktualisierten Range übernommen.

Ist targetObj kein Range, wird rangeUpdate ignoriert.

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 Bookmark range(WParea;$_BookmarkNames{$p}) //Range auswählen

    $RangeDoc:=WP New($Range) //aus Range ein neues Dokument 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

Download HDI database
WP INSERT BREAK
WP INSERT PICTURE
WP New