Skip to main content
Version: Next

VP Export to object

VP Export to object ( vpAreaName : Text {; options : Object} ) : Object

ParameterTypeDescription
vpAreaNameText->4D View Pro area form object name
optionsObject->Export options
ResultObject<-4D View Pro object

Description

The VP Export to object command returns the 4D View Pro object attached to the 4D View Pro area vpAreaName. You can use this command for example to store the 4D View Pro area in a 4D database object field.

In vpAreaName, pass the name of the 4D View Pro area. If you pass a name that does not exist, an error is returned.

In the options parameter, you can pass the following export options, if required:

PropertyTypeDescription
includeFormatInfoBooleanTrue (default) to include formatting information, false otherwise. Formatting information is useful in some cases, e.g. for export to SVG. On the other hand, setting this property to False allows reducing export time.
includeBindingSourceBooleanTrue (default) to export the current data context values as cell values in the exported object (data contexts themselves are not exported). False otherwise. Cell binding is always exported.

For more information on 4D View Pro objects, please refer to the 4D View Pro object paragraph.

Example 1

You want to get the "version" property of the current 4D View Pro area:

var $vpAreaObj : Object
var $vpVersion : Number
$vpAreaObj:=VP Export to object("vpArea")
// $vpVersion:=OB Get($vpAreaObj;"version")
$vpVersion:=$vpAreaObj.version

Example 2

You want to export the area, excluding formatting information:

var $vpObj : Object
$vpObj:=VP Export to object("vpArea";New object("includeFormatInfo";False))

See also

VP Convert to picture
VP EXPORT DOCUMENT
VP IMPORT FROM OBJECT