Share

GenericZone.CreateSketchBased Method

Creates a new instance of a sketch-based generic zone and adds it to the document.


Namespace: Autodesk.Revit.DB.Analysis
Assembly: RevitAPI (in RevitAPI.dll) Version: 26.1.0.0 (26.1.0.34)

Syntax

C#

public static GenericZone CreateSketchBased(
	Document doc,
	ElementId typeId,
	string name,
	GenericZoneDomainData domainData,
	ElementId levelId,
	IList<CurveLoop> curveLoops
)

Parameters

doc  Document
The document where the element will be created and added.
typeId  ElementId
The sketch-based element type for the new generic zone.
name  String
The name of the generic zone to be created.
domainData  GenericZoneDomainData
The specific domain requirements for the generic zone.
levelId  ElementId
The base level on which the generic zone will be created.
curveLoops  IList<CurveLoop>
The loops that define the lines, curves and areas that overlap or crosses the elements you want to belong to the zone. Multiple loops are allowed, they can be open or closed, but they should be on the same horizontal plane.

Return Value

GenericZone
The newly created generic zone.

Exceptions

ExceptionCondition
ArgumentException The element type is not a valid sketch-based type for this generic zone. -or- name is an empty string. -or- name cannot include prohibited characters, such as "{, }, [, ], |, ;, less-than sign, greater-than sign, ?, `, ~". -or- The ElementId levelId is not a Level. -or- The curve loops in the input array are empty. -or- The input curve loops do not all lie in the same horizontal plane.
ArgumentNullException A non-optional argument was null
InvalidOperationException The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements).
ModificationForbiddenException The document is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document is being loaded, or is in the midst of another sensitive process.
ModificationOutsideTransactionException The document has no open transaction.

See Also

Reference

Was this information helpful?