ItemFactoryBase.NewDimension(View, Line, ReferenceArray) Method

Namespace: Autodesk.Revit.Creation
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.3.0.0 (25.3.0.0)

Syntax

C#

public Dimension NewDimension(
	View view,
	Line line,
	ReferenceArray references
)

Parameters

view  View

The view in which the dimension is to be visible. The view must be null if the document is in [!:Autodesk::Revit::DB::SketchEditScope].

line  Line

The line drawn for the dimension.

references  ReferenceArray

An array of geometric references to which the dimension is to be bound.

Return Value

Dimension
If successful a new dimension object, otherwise null.

Exceptions

Remarks

The currently user set default style is used for the created dimension.

Example

C#

Dimension CreateNewDimensionAlongLine(Autodesk.Revit.DB.Document document, Line line)
{
    // Use the Start and End points of our line as the references  
    // Line must come from something in Revit, such as a beam
    ReferenceArray references = new ReferenceArray();
    references.Append(line.GetEndPointReference(0));
    references.Append(line.GetEndPointReference(1));

    // create the new dimension
    Dimension dimension = document.Create.NewDimension(document.ActiveView,
                                                        line, references);
    return dimension;
}

VB

Private Function CreateNewDimensionAlongLine(document As Autodesk.Revit.DB.Document, line As Line) As Dimension
    ' Use the Start and End points of our line as the references  
    ' Line must come from something in Revit, such as a beam
    Dim references As New ReferenceArray()
    references.Append(line.GetEndPointReference(0))
    references.Append(line.GetEndPointReference(1))

    ' create the new dimension
    Dim dimension As Dimension = document.Create.NewDimension(document.ActiveView, line, references)
    Return dimension
End Function

See Also

Reference