Skip to main content
Version: Next

VP Convert to picture

VP Convert to picture ( vpObject : Object {; rangeObj : Object} ) : Picture

ParameterTypeDescription
vpObjectObject->4D View Pro object containing the area to convert
rangeObjObject->Range object
ResultPicture<-SVG picture of the area

Description

The VP Convert to picture command converts the vpObject 4D View Pro object (or the rangeObj range within vpObject) to a SVG picture.

This command is useful, for example:

  • to embed a 4D View Pro document in an other document such as a 4D Write Pro document
  • to print a 4D View Pro document without having to load it into a 4D View Pro area.

In vpObject, pass the 4D View Pro object that you want to convert. This object must have been previously parsed using VP Export to object or saved using VP EXPORT DOCUMENT.

SVG conversion process requires that expressions and formats (cf. Cell Format) included in the 4D View Pro area be evaluated at least once, so that they can be correctly exported. If you convert a document that was not evaluated beforehand, expressions or formats may be rendered in an unexpected way.

In rangeObj, pass a range of cells to convert. By default, if this parameter is omitted, the whole document contents are converted.

Document contents are converted with respect to their viewing attributes, including formats (see note above), visibility of headers, columns and rows. The conversion of the following elements is supported:

  • Text : style / font / size / alignment / orientation / rotation / format
  • Cell background : color / image
  • Cell borders : thickness / color / style
  • Cell merge
  • Pictures
  • Row height
  • Column width
  • Hidden columns / rows.

Gridline visibility depends on document attribute defined with VP SET PRINT INFO.

Function result

The command returns a picture in SVG format.

Example

You want to convert a 4D View Pro area in SVG, preview the result, and send it to a picture variable:

C_OBJECT($vpAreaObj)
C_PICTURE($vPict)
$vpAreaObj:=VP Export to object("ViewProArea")
$vPict:=VP Convert to picture($vpAreaObj) //export the whole area

See also

VP EXPORT DOCUMENT
VP Export to object
VP SET PRINT INFO