| Revit 2017 API |
| Document..::..NewDuct Method (XYZ, XYZ, DuctType) |
| Document Class See Also |
Adds a new duct into the document,
using two points and duct type.
Namespace: Autodesk.Revit.Creation
Assembly: RevitAPI (in RevitAPI.dll) Version: 17.0.0.0 (17.0.484.0)
Syntax
| C# |
|---|
[ObsoleteAttribute("This method is obsolete in Revit 2017. Please use Duct.Create() instead.")] public Duct NewDuct( XYZ point1, XYZ point2, DuctType ductType ) |
| Visual Basic |
|---|
<ObsoleteAttribute("This method is obsolete in Revit 2017. Please use Duct.Create() instead.")> _ Public Function NewDuct ( _ point1 As XYZ, _ point2 As XYZ, _ ductType As DuctType _ ) As Duct |
| Visual C++ |
|---|
[ObsoleteAttribute(L"This method is obsolete in Revit 2017. Please use Duct.Create() instead.")] public: Duct^ NewDuct( XYZ^ point1, XYZ^ point2, DuctType^ ductType ) |
Parameters
- point1
- Type: Autodesk.Revit.DB..::..XYZ
The first point of the duct.
- point2
- Type: Autodesk.Revit.DB..::..XYZ
The second point of the duct.
- ductType
- Type: Autodesk.Revit.DB.Mechanical..::..DuctType
The type of the duct.
Return Value
If creation was successful then a new duct is returned, otherwise an exception with failure information will be thrown.
Exceptions
| Exception | Condition |
|---|---|
| Autodesk.Revit.Exceptions..::..ArgumentNullException | Thrown when the input argument point1 or point2 is nullNothingnullptra null reference (Nothing in Visual Basic). |
| Autodesk.Revit.Exceptions..::..InvalidOperationException | Thrown when the duct cannot be created or regenerate fails. |
| Autodesk.Revit.Exceptions..::..ArgumentException | Thrown if the duct type does not exist in the given document. |