M

ItemFactoryBase.NewDimension

Description:
Creates a new linear dimension object using the default dimension style.

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

Overloads (2):

NewDimension(View,Line,ReferenceArray)

NewDimension(View,Line,ReferenceArray,DimensionType)

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

Public Function NewDimension ( _
	view As View, _
	line As Line, _
	references As ReferenceArray _
) As Dimension

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

Autodesk.Revit.DB.View

view

The view in which the dimension is to be visible. The view must be nulla null reference (Nothing in Visual Basic) if the document is in SketchEditScope.
Autodesk.Revit.DB.Line

line

The line drawn for the dimension.
Autodesk.Revit.DB.ReferenceArray

references

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

Return Value nullNothingnullptr If successful a new dimension object, otherwise null Nothing nullptr a null reference ( Nothing in Visual Basic) .

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;
}

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

Autodesk.Revit.Exceptions.ArgumentException

Thrown when references are not geometric references.