VP Convert to picture

Home

4D v19


VP Convert to picture ( vpObject {; rangeObj} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
vpObject	Objekt	4D View Pro Objekt mit dem Bereich zum Konvertieren
rangeObj	Objekt	Range Objekt
Funktionsergebnis	Bild	SVG Bild des Bereichs

Beschreibung

Der Befehl VP Convert to picture konvertiert das 4D View Pro Objekt vpObject (oder einen Teil rangeObj innerhalb von vpObject) in ein SVG Bild.

Dieser Befehl ist zum Beispiel hilfreich, um:

Ein 4D View Pro Dokument in ein anderes Dokument, z.B. ein 4D Write Pro Dokument einzubinden
Ein 4D View Pro Dokument ohne vorheriges Laden in einen 4D View Pro Bereich zu drucken, z.B. offscreen auf dem Server

In vpObject übergeben Sie das 4D View Pro Objekt zum Konvertieren. Dieses Objekt muss zuvor über VP Export to object analysiert oder über VP EXPORT DOCUMENT gesichert werden.

Hinweis: Für die Konvertierung in SVG müssen Ausdrücke und Formate (siehe 4D View Pro Zellenformat) im 4D View Pro Bereich mindestens einmal bewertet werden, damit sie korrekt exportiert werden können. Konvertieren Sie ein Dokument ohne vorherige Bewertung, können Ausdrücke oder Formate unerwartete Ergebnisse anzeigen.

In rangeObj übergeben Sie ein Zellen-Range zum Konvertieren. Ohne diese Angabe wird standardmäßig der gesamte Inhalt des Dokuments konvertiert.

Der Inhalt des Dokuments wird zusammen mit seinen Attributen zur Anzeige konvertiert, inkl. Formate. Beim Konvertieren werden folgende Elemente unterstützt:

Text : Stil / Schrift / Größe / Ausrichtung / Drehung / Format
Zellenhintergrund: Farbe / Bild
Zellenränder: Stärke / Farbe / Stil
Zellen zusammenfügen
Bilder
Zeilenhöhe
Spaltenbreite
Ausgeblendete Spalten / Zeilen

Die Anzeige von Gittenlinien hängt davon ab, ob dieses Druckattribut mit VP SET PRINT INFO definiert wurden.

Funktionsergebnis

Der Befehl gibt ein Bild im SVG Format zurück.

Beispiel

Einen 4D View Pro Bereich in SVG konvertieren, das Ergebnis als Vorschau zeigen und an eine Bildvariable senden:

 C_OBJECT($vpAreaObj)

 C_PICTURE($vPict)

 $vpAreaObj:=VP Export to object("ViewProArea")

 $vPict:=VP Convert to picture($vpAreaObj) //export the whole area

Siehe auch

VP EXPORT DOCUMENT
VP Export to object
VP SET PRINT INFO