4D v16
WP New
- 4D Write Pro Handbuch
-
- 4D Write Pro Programmiersprache
-
- Über 4D Write Pro Objekte
- Befehle aus dem Kapitel Objekte (Formulare) verwenden
- Befehle aus dem Kapitel Mehrfachstil Text verwenden
- Per Programmierung auf Dokumentinhalte zugreifen
- 4D Write Pro Konstanten
- WP CREATE BOOKMARKNew
- WP DELETE BOOKMARKNew
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get bookmark rangeNew
- WP GET BOOKMARKSNew
- WP Get page countNew
- WP Get paragraphs
- WP Get pictures
- WP Get range
- WP Get selection
- WP Import document
- WP INSERT BREAKNew
- WP INSERT DOCUMENTNew
- WP INSERT PICTURENew
- WP Is font style supported
- WP NewUpd
- WP PRINTUpd
- WP RESET ATTRIBUTES
- WP SELECT
- WP SET ATTRIBUTES
- WP USE PAGE SETUP
- 4D Write Pro Attribute
WP New
| WP New {( Quelle )} -> Funktionsergebnis | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| Quelle | String, BLOB, Objekt |
|
String: 4D HTML Quelle BLOB: 4D Write Blob Dokument (.4w7 .4wt) oder 4D Write Pro Dokument (.4wp) Objekt: Ein 4D Write Pro Ausschnitt |
|||||
| Funktionsergebnis | Objekt |
|
4D Write Pro Objekt | |||||
Die Funktion WP New erstellt bzw. gibt ein Objekt 4D Write Pro zurück.
Lassen Sie den Parameter Quelle weg, gibt die Funktion standardmäßig ein leeres Objekt 4D Write Pro zurück.
Übergeben Sie den Parameter Quelle, wird das neue Objekt 4D Write Pro mit dem Inhalt von Quelle 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 .
- 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 4D Write Dokumente 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 ein Objekt 4D Write Pro Ausschnitt. WP New gibt ein neues Dokument zurück, erstellt aus einem spezifischen Ausschnitt. Beachten Sie, dass der Bereich nicht gleich ist mit dem ganzen Dokumentausschnitt. Nur der erste Abschnitt wird exportiert, evtl. vorhandene Lesezeichen werden nicht exportiert.
Das zurückgegebene Objekt ist ein komplettes Dokument, das z.B. dem Befehl WP INSERT DOCUMENT übergeben werden kann.
Ein leeres Objekt 4D Write Pro erstellen:
myWPObject:=WP NewEin 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)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)Ein 4D Write Dokument, das in einem 4D Feld des aktuellen Datensatzes 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 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
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Erstellt: 4D v14 R5
Geändert: 4D v15 R2
Geändert: 4D v16
4D Write Pro Handbuch ( 4D v16)
