4D v17
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 Add picture
- WP CREATE BOOKMARK
- WP Create paragraph range
- WP Create picture range
- WP Create range
- WP Create table rangeNew
- WP DELETE BOOKMARK
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get body
- WP Get bookmark range
- WP GET BOOKMARKS
- WP Get element by IDNew
- WP Get elementsNew
- WP Get footer
- WP Get frame
- WP Get header
- WP Get page count
- WP Get positionNew
- WP Get selection
- WP Get textNew
- WP Import document
- WP INSERT BREAKUpd
- WP INSERT DOCUMENT
- WP INSERT PICTURE
- WP Insert table
- WP Is font style supported
- WP New
- WP PRINT
- WP RESET ATTRIBUTES
- WP SELECT
- WP SET ATTRIBUTES
- WP SET FRAME
- WP SET TEXTNew
- WP Table append row
- WP Table get cellsUpd
- WP Table get columnsUpd
- WP Table get rowsUpd
- WP USE PAGE SETUP
- 4D Write Pro Attribute
WP New
| WP New {( Quelle )} -> Funktionsergebnis | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| Quelle | String, BLOB, Objekt |
|
HTML Quelle oder 4D Write Blob Dokument oder 4D Write Pro Blob Dokument oder Range oder Referenz auf Element |
|||||
| 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 . - 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.
- ein Dokument im 4D Write Pro Format (.4wp), das in einem BLOB gespeichert ist.
- 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. - oder eine Referenz auf ein Element (Tabelle, Zeile, Absatz, Bild im Textfluss, Kopf- oder Fußteil).
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.
- Range
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 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)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)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 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
Produkt: 4D
Thema: 4D Write Pro Programmiersprache
Nummer:
1317
Erstellt: 4D v14 R5
Geändert: 4D v15 R2
Geändert: 4D v16
Geändert: 4D v16 R5
4D Write Pro Handbuch ( 4D v17)
