4D Doc Center : PV SET DOCUMENT PROPERTY

Home

4D View v14

PV SET DOCUMENT PROPERTY


PV SET DOCUMENT PROPERTY ( area ; option ; value )

Parameter	Type	Description
area	Longint	4D View area
option	Longint	Property number
value	Longint	Property value

Description

The PV SET DOCUMENT PROPERTY command sets the value of the property set by option for the 4D View document in area.

The PV Document properties constants are used to define the option parameter:

Constant	Type	Value	Comment
pv column count	Longint	0	Allows setting or reading of the number of columns displayed in the area.
pv document modified	Longint	4	Allows setting or reading of the "modified" attribute of area. Associated values: pv value on or pv value off. When this constant is used in write mode ( PV SET DOCUMENT PROPERTY command), passing pv value on in the value parameter will cause a warning dialog box to be displayed when the area is closed indicating that it has been modified. If the value parameter contains pv value off, and if the document is not modified subsequently by the user or by programming, this dialog box does not appear. When this constant is used in read mode, using the PV Get document property command, the value returned is 1 if the document has been modified, and 0 otherwise.
pv no external call	Longint	3	Allows forbidding of calls to 4D variables, methods and commands in the formulas of the area. Associated values: pv value on or pv value off. pv value on: calls to 4D variables, methods and commands are forbidden in the formulas (in this case, it is possible to use “PV Allows Input” theme commands to define which 4D objects can be called). pv value off: calls to all 4D variables, methods and commands are allowed in the formulas (default value).
pv row count	Longint	1	Allows setting or reading of the number of rows displayed in the area.

Example 1

This generic method allows setting the number of columns and/or rows for a new 4D View area (during form load, for example).

 PV SET DOCUMENT PROPERTY(Area;pv column count;10) `10 columns

 PV SET DOCUMENT PROPERTY(Area;pv row count;20) `20 rows

Example 2

This method, associated for example with a 4D View document close button, allows never displaying the alert dialog box indicating that the area has been modified:

 If(PV Get document property(Area;pv document modified)#0)

    PV SET DOCUMENT PROPERTY(Area;pv document modified;0) `0 = unchanged, 1 = changed

 End if