Handling 4D View Pro areas

Home

4D v17

Architecture

When working with 4D View Pro areas in your forms, you need to handle several elements:

The 4D View Pro form area (4D form object): contains and displays the 4D View Pro object. This area is defined by a name ("Object name" field in the Property list).
The 4D View Pro object (C_OBJECT type variable or expression): stores the whole spreadsheet contents (see below). You can get or set this object using the VP IMPORT FROM OBJECT or VP Export to object commands.
The 4D View Pro document (.4vp documents): stores the whole spreadsheet contents in JSON format.

When loading a 4D View Pro object in a form area, 4D generates the On VP Ready form event once the whole area is loaded. You must execute any 4D View Pro code handling the area in this event, otherwise an error is returned.

4D View Pro object

The 4D View Pro object describes the document and is automatically handled by the 4D View Pro commands. It contains the following properties:

Property	Value type	Description
version	Longint	Internal component version
dateCreation	Timestamp	Creation date
dateModified	Timestamp	Last modification date
meta	Object	Free contents, reserved for the 4D developer
spreadJS	Object	Reserved for the 4D View Pro component