4D v17

WP INSERT DOCUMENT

Home

 
4D v17
WP INSERT DOCUMENT

WP INSERT DOCUMENT 


 

WP INSERT DOCUMENT ( AusschnittObj ; wpDok ; Modus {; UpdateAusschnitt} )  
Parameter Typ   Beschreibung
AusschnittObj  Objekt in Ausschnitt
wpDok  Objekt in 4D Write Pro Dokument
Modus  Lange Ganzzahl in Einfügemodus
UpdateAusschnitt  Lange Ganzzahl in 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



Siehe auch 


WP INSERT BREAK
WP INSERT PICTURE
WP New

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer: 1411

Dieser Befehl kann in preemptive Prozessen laufen

 
GESCHICHTE 

Erstellt: 4D v16

 
ARTIKELVERWENDUNG

4D Write Pro Handbuch ( 4D v17)