SplitRegionVertically Method


Splits vertically one region in split crop.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since:  2016

Syntax

C#
public void SplitRegionVertically(
	int regionIndex,
	double topPart,
	double bottomPart
)
Visual Basic
Public Sub SplitRegionVertically ( _
	regionIndex As Integer, _
	topPart As Double, _
	bottomPart As Double _
)
Visual C++
public:
void SplitRegionVertically(
	int regionIndex, 
	double topPart, 
	double bottomPart
)

Parameters

regionIndex
Type: SystemInt32
Index of region to be split vertically (numbering starts with 0).
topPart
Type: SystemDouble
Relative portion of the original region to become the new top region (0 to 1).
bottomPart
Type: SystemDouble
Relative portion of the original region to become the new bottom region (0 to 1).

Remarks

This function splits the crop into two regions: one occupying the top quarter of the crop, and the other the bottom quarter of the crop.

Exceptions

ExceptionCondition
Autodesk.Revit.ExceptionsArgumentException The provided view region proportions are not valid. -or- The provided region index is invalid.
Autodesk.Revit.ExceptionsInvalidOperationException The crop of the associated view is not permitted to have multiple regions. -or- The view has non-rectangular crop shape set. -or- The view crop is already split horizontally.

See Also

ArchiLabs

Stop fighting Revit automation.

Build repeatable BIM design and documentation workflows with scripts, data, and AI in one place, without wrestling brittle one-off automations.

Try ArchiLabs →