M

SketchPlane.Create

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

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

Overloads (3):

Create(Document,ElementId)

Create(Document,Plane)

Create(Document,Reference)

public static SketchPlane Create(
	Document document,
	Reference planarFaceReference
)

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

public:
static SketchPlane^ Create(
	Document^ document, 
	Reference^ planarFaceReference
)

Autodesk.Revit.DB.Document

document

The document.
Autodesk.Revit.DB.Reference

planarFaceReference

The reference of the planar face where the sketch plane will be created.

Return Value SketchPlane The newly created sketch plane.

Autodesk.Revit.Exceptions.ArgumentException

Sketch plane creation is not allowed in this family. -or- The reference is not a planar face.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was null
Autodesk.Revit.Exceptions.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.
Autodesk.Revit.Exceptions.ModificationOutsideTransactionException

The document has no open transaction.