VP Combine ranges

Home

4D v19

VP Combine ranges


VP Combine ranges ( rangeObj ; otherRangeObj {; otherRangeObj2 ; ... ; otherRangeObjN} ) -> Function result

Parameter	Type	Description
rangeObj	Object	Range object
otherRangeObj	Object	Range object
Function result	Object	Object containing a combined range

Description

The VP Combine ranges command returns a new range object that incorporates two or more existing range objects. All of the ranges must be from the same 4D View Pro area.

In rangeObj, pass the first range object.

In otherRangeObj, pass another range object(s) to combine with rangeObj.

Note: The command incorporates rangeObj and otherRangeObj objects by reference.

Example

You want to combine cell, column, and row range objects in a new, distinct range object:

 $cell:=VP Cell("ViewProArea";2;4) // C5

 $column:=VP Column("ViewProArea";3) // column D

 $row:=VP Row("ViewProArea";9) // row 10

 

 $combine:=VP Combine ranges($cell;$column;$row)