WP New

Home

4D v19

WP New


WP New {( source {; Option} )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
source	String, BLOB, Objekt	String: HTML Quelle BLOB: 4D Write Pro Dokument (.4wp) oder bisheriges 4D Write Dokument (.4w7/.4wt) Objekt: Range, Element oder 4D Write Pro Dokument
Option	Lange Ganzzahl	Importoption für HTML Ausdrücke
Funktionsergebnis	Objekt	4D Write Pro Objekt

Beschreibung

Die Funktion WP New erstellt bzw. gibt ein Objekt 4D Write Pro zurück.

Lassen Sie den Parameter source weg, gibt die Funktion ein leeres Objekt 4D Write Pro zurück.

Übergeben Sie den Parameter source wird das neue Objekt 4D Write Pro mit dem Inhalt von source gefüllt. Sie können folgendes übergeben:

String: Damit übergeben Sie eine 4D HTML Quelle, z.B. einen Text, der mit WP EXPORT VARIABLE mit der Option wk web page html 4D exportiert wurde. Dieser Text kann Referenzen (4D Tags und Ausdrücke) und eingebundene Bilder enthalten.
BLOB: Damit übergeben Sie entweder:
- ein Dokument im 4D Write Pro Format (.4wp), das in einem BLOB gespeichert ist.
  Weitere Informationen dazu finden Sie im Abschnitt Dokumentformat .4wp .
- oder einen bisher üblichen 4D Write Bereich, der in ein BLOB geladen ist (unterstützt werden BLOBS mit .4w7 oder .4wt Dokumenten).
  Eine ausführliche Liste von 4D Write Features, die derzeit in 4D Write Pro Objekten unterstützt werden, finden Sie im Abschnitt Ein 4D Write Dokument importieren. Um ein 4D Write Dokument (.4w7 oder .4wt) von der Festplatte zu importieren, können Sie auch die Funktion WP Import document verwenden.

Objekt: Damit übergeben Sie entweder:

Range
Dann gibt WP New ein neues Dokument mit dem spezifischen Range zurück. Ist der Range nicht gleich mit dem ganzen Dokumentbereich, wird nur der erste Abschnitt exportiert, evtl. vorhandene Lesezeichen werden nicht exportiert.
ein Element (Tabelle, Zeile, Absatz, Hauptteil, Kopf- oder Fußteil, Bild im Textfluss, Abschnitt, Unterabschnitt, Stilvorlage).
Dann gibt WP New ein neues Dokument zurück, das nur den Inhalt eines Elements im Hauptteil enthält. Für eine Zeile enthält das neue Dokument ein Tabellenelement mit der Zeile.
oder ein 4D Write Pro Dokument.
WP New gibt eine Kopie des angegebenen Dokuments zurück.

Hinweise zur Kompatibilität:

In 4D Write Dokumenten eingefügte HTML Ausdrücke werden standardmäßig nicht importiert (keine Unterstützung in 4D Write Pro). Übergeben Sie die Konstante wk import html expressions as text im Parameter Option, werden HTML Ausdrücke als reiner Text zwischen den Tags ##htmlBegin## und ##htmlEnd## importiert, d.h. hier sind anschließend Formatierungen erforderlich. Beispiel:

##htmlBegin##<span>Imported title<b>bold</b></span>##htmlEnd##

Zeichen Stilvorlagen in bisherigen 4D Write Dokumenten verwenden einen eigenen Mechanismus, den 4D Write Pro nicht unterstützt. Um das bestmögliche Ergebnis für importierten Text zu erhalten, werden Attribute von Stilvorlagen in "hardcodierte" Stilattribute konvertiert. Bisherige Zeichen Stilvorlagen werden nicht importiert und im 4D Write Pro Dokument wird nicht mehr darauf verwiesen.

Beispiel 1

Ein leeres Objekt 4D Write Pro erstellen:

myWPObject:=WP New

Beispiel 2

Ein neues 4D Write Pro Objekt für ein 4D Write Pro Dokument erstellen, das auf der Festplatte gesichert ist:

 C_BLOB($BlobDoc)

 C_OBJECT(myWPArea)

 DOCUMENT TO BLOB("myDoc.4wp";$BlobDoc) //das Dokument in ein Blob laden

 myWPArea:=WP New($BlobDoc)

Beispiel 3

Ein Objekt 4D Write Pro mit Referenz auf einen 4D Ausdruck erstellen:

 C_TEXT(myText)

 myText:="Heute ist "

 ST INSERT EXPRESSION(myText;"string(current date;System date long)";ST End text)

 myWPA:=WP New(myText)

Beispiel 4

Ihren 4D Write Pro Bereich mit einer zuvor erstellten Vorlage initialisieren:

  //Vorlage aus einem vorhandenen Bereich exportieren

 C_TEXT(wpTemplate)

 WP EXPORT VARIABLE(myWPArea;wpTemplate;wk web page html 4D)

 

  // Die Vorlage für einen neuen Bereich verwenden

 C_OBJECT(myNewWPA)

 myNewWPA:=WP New(wpTemplate)

Beispiel 5

Ein Dokument, das in einem BLOB Feld des aktuellen Datensatzes im bisherigen Plug-In 4D Write gespeichert ist, in einen neuen 4D Write Pro Bereich importieren:

 C_OBJECT(wpArea)

 wpArea=WP New([Templates]Reference_)

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 Import document
WP INSERT DOCUMENT

WP New

Beschreibung

Beispiel 1

Beispiel 2

Beispiel 3

Beispiel 4

Beispiel 5

Beispiel 6