Creates a new sketch plane from a reference to a planar face.

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

Syntax

C#
`public static SketchPlane Create( Document document, Reference planarFaceReference )`

Visual Basic
`Public Shared Function Create ( _ document As Document, _ planarFaceReference As Reference _ ) As SketchPlane`

Visual C++
`public: static SketchPlane^ Create( Document^ document, Reference^ planarFaceReference )`

planarFaceReference: Type: Autodesk.Revit.DBReference
The reference of the planar face where the sketch plane will be created.

The newly created sketch plane.

Remarks

A reference relationship will be created between the face and the sketch plane.

Exception	Condition
Autodesk.Revit.ExceptionsArgumentException	Sketch plane creation is not allowed in this family. -or- The reference is not a planar face.
Autodesk.Revit.ExceptionsArgumentNullException	A non-optional argument was null
Autodesk.Revit.ExceptionsModificationForbiddenException	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.
Autodesk.Revit.ExceptionsModificationOutsideTransactionException	The document has no open transaction.