4D v13

PV SET DOCUMENT PROPERTY

Home

 
4D View v13
4D View Language
PV Document
PV SET DOCUMENT PROPERTY

PV SET DOCUMENT PROPERTY 


 

PV SET DOCUMENT PROPERTY ( area ; option ; value ) 
Parameter Type   Description
area  Longint in 4D View area
option  Longint in Property number
value  Longint in Property value

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.

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

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

 
PROPERTIES 

Product: 4D
Theme: PV Document
Number: 15985

 
INDEX

Alphabetical list of commands

 
HISTORY 

Created: 4D View 6.8

 
SEE ALSO 

PV Get document property