Revit 2025 API
Item |
Creates a new linear dimension object using the default dimension style.
Namespace: Autodesk.Revit.Creation
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.0.0.0 (25.0.0.0)
Syntax
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 )
member NewDimension : view : View * line : Line * references : ReferenceArray -> Dimension
Parameters
- view View
- The view in which the dimension is to be visible. The view must be 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
DimensionIf successful a new dimension object, otherwise .
Exceptions| Exception | Condition |
|---|---|
| ArgumentException | Thrown when references are not geometric references. |
Remarks The currently user set default style is used for the created dimension.
ExampleDimension 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
No code example is currently available or this language may not be supported.
No code example is currently available or this language may not be supported.
See Also