Namespace: Autodesk.Revit.Creation Class: FamilyItemFactory

FamilyItemFactory.NewCurveByPoints

Method

Description:
Create a 3d curve through two or more points in an Autodesk Revit family document.

Syntax

public CurveByPoints NewCurveByPoints(
	ReferencePointArray points
)

Public Function NewCurveByPoints ( 
	points As ReferencePointArray
) As CurveByPoints

public:
CurveByPoints^ NewCurveByPoints(
	ReferencePointArray^ points
)

member NewCurveByPoints : 
        points : ReferencePointArray -> CurveByPoints

Examples

ReferencePointArray rpa = new ReferencePointArray();

XYZ xyz = document.Application.Create.NewXYZ(0, 0, 0);
ReferencePoint rp = document.FamilyCreate.NewReferencePoint(xyz);
rpa.Append(rp);

xyz = document.Application.Create.NewXYZ(0, 30, 10);
rp = document.FamilyCreate.NewReferencePoint(xyz);
rpa.Append(rp);

xyz = document.Application.Create.NewXYZ(0, 60, 0);
rp = document.FamilyCreate.NewReferencePoint(xyz);
rpa.Append(rp);

xyz = document.Application.Create.NewXYZ(0, 100, 30);
rp = document.FamilyCreate.NewReferencePoint(xyz);
rpa.Append(rp);

xyz = document.Application.Create.NewXYZ(0, 150, 0);
rp = document.FamilyCreate.NewReferencePoint(xyz);
rpa.Append(rp);

curve = document.FamilyCreate.NewCurveByPoints(rpa);

Dim rpa As New ReferencePointArray()

Dim xyz As XYZ = document.Application.Create.NewXYZ(0, 0, 0)
Dim rp As ReferencePoint = document.FamilyCreate.NewReferencePoint(xyz)
rpa.Append(rp)

xyz = document.Application.Create.NewXYZ(0, 30, 10)
rp = document.FamilyCreate.NewReferencePoint(xyz)
rpa.Append(rp)

xyz = document.Application.Create.NewXYZ(0, 60, 0)
rp = document.FamilyCreate.NewReferencePoint(xyz)
rpa.Append(rp)

xyz = document.Application.Create.NewXYZ(0, 100, 30)
rp = document.FamilyCreate.NewReferencePoint(xyz)
rpa.Append(rp)

xyz = document.Application.Create.NewXYZ(0, 150, 0)
rp = document.FamilyCreate.NewReferencePoint(xyz)
rpa.Append(rp)

curve = document.FamilyCreate.NewCurveByPoints(rpa)

Parameters

Parameter	Type	Description
points	ReferencePointArray	Two or more PointElements. The curve will interpolate these points.

Return Value

Type	Description
CurveByPoints	The newly created curve.

Exceptions

Exception	Condition
ArgumentNullException	Thrown when points is.
ArgumentException	Thrown when points does not contain at least two PointElements.
InvalidOperationException	Thrown when the family is not a Conceptual Mass Family.