VP Cells
VP Cells ( vpAreaName : Text ; column: Integer ; row: Integer ; columnCount : Integer ; rowCount : Integer { ; sheet : Integer } ) : Object
History
| Release | Changes |
|---|---|
| 17 R4 | Added |
| Parameter | Type | Description | |
|---|---|---|---|
| vpAreaName | Text | -> | 4D View Pro area form object name |
| column | Integer | -> | Column index |
| row | Integer | -> | Row index |
| columnCount | Integer | -> | Number of columns |
| rowCount | Integer | -> | Number of rows |
| sheet | Integer | -> | Sheet index (current sheet if omitted) |
| Result | Object | <- | Range object of cells |
Description
The VP Cells command returns a new range object referencing specific cells.
In vpAreaName, pass the name of the 4D View Pro area. If you pass a name that does not exist, an error is returned.
The column parameter defines the first column of the cell range. Pass the column index (counting begins at 0) in this parameter. If the range is within multiple columns, you should also use the columnCount parameter.
In the row parameter, you can define the row(s) of the cell range's position. Pass the row index (counting begins at 0) in this parameter. If the range is within multiple rows, you should also use the rowCount parameter.
The columnCount parameter allows you to define the total number of columns the range is within. columnCount must be greater than 0.
The rowCount parameter allows you to define the total number of rows the range is within. rowCount must be greater than 0.
In the optional sheet parameter, you can designate a specific spreadsheet where the range will be defined (counting begins at 0). If omitted or if you pass vk current sheet, the current spreadsheet is used by default.
Example
You want to define a range object for the following cells (on the current sheet):
The code would be:
$cells:=VP Cells("ViewProArea";2;4;2;3) // C5 to D7