Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
4D v19
VP Convert to picture

VP Convert to picture 


 

VP Convert to picture ( vpObject {; rangeObj} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
vpObject  Objekt in 4D View Pro Objekt mit dem Bereich zum Konvertieren
rangeObj  Objekt in Range Objekt
Funktionsergebnis  Bild in SVG Bild des Bereichs

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.

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

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: 4D View Pro Programmiersprache
Nummer: 9885

 
SEITENINHALT 
 
GESCHICHTE 

Erstellt: 4D v18

 
ARTIKELVERWENDUNG

4D View Pro Handbuch ( 4D v19)