4D v17WP INSERT DOCUMENT |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v17
WP INSERT DOCUMENT
|
WP INSERT DOCUMENT ( AusschnittObj ; wpDok ; Modus {; UpdateAusschnitt} ) | ||||||||
Parameter | Typ | Beschreibung | ||||||
AusschnittObj | Objekt |
![]() |
Ausschnitt | |||||
wpDok | Objekt |
![]() |
4D Write Pro Dokument | |||||
Modus | Lange Ganzzahl |
![]() |
Einfügemodus | |||||
UpdateAusschnitt | Lange Ganzzahl |
![]() |
Modus für Update Ausschnitt | |||||
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 einen Ausschnitt.
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 Ziels ein |
wk prepend | Lange Ganzzahl | 1 | Fügt Inhalt am Anfang des Ziels 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 | 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 ist nicht in aktualisierten Range enthalten |
wk include in range | Lange Ganzzahl | 0 | Eingefügter Inhalt ist im aktualisierten Range enthalten (Standard) |
Standardmäßig, d.h. ohne den Parameter UpdateAuschnitt wird der eingefügte Inhalt in den Zielbereich übernommen.
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
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
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer:
1411
Erstellt: 4D v16
4D Write Pro Handbuch ( 4D v17)