Revit 2024 API |
TopographySurface..::..ChangePointsElevation Method |
TopographySurface Class See Also |
Changes the elevation value for points
Namespace: Autodesk.Revit.DB.Architecture
Assembly: RevitAPI (in RevitAPI.dll) Version: 24.0.0.0 (24.0.0.0)
Since:
2014
Syntax
C# |
---|
[ObsoleteAttribute("This method is deprecated in Revit 2024 with the introduction of the new Toposolid elements. It is recommended that TopographySurface elements should be converted to Toposolid elements to enable better editing options.")] public void ChangePointsElevation( IList<XYZ> points, double elevationValue ) |
Visual Basic |
---|
<ObsoleteAttribute("This method is deprecated in Revit 2024 with the introduction of the new Toposolid elements. It is recommended that TopographySurface elements should be converted to Toposolid elements to enable better editing options.")> _ Public Sub ChangePointsElevation ( _ points As IList(Of XYZ), _ elevationValue As Double _ ) |
Visual C++ |
---|
[ObsoleteAttribute(L"This method is deprecated in Revit 2024 with the introduction of the new Toposolid elements. It is recommended that TopographySurface elements should be converted to Toposolid elements to enable better editing options.")] public: void ChangePointsElevation( IList<XYZ^>^ points, double elevationValue ) |
Parameters
- points
- Type: System.Collections.Generic..::..IList<(Of <(<'XYZ>)>)>
The points to be modified.
- elevationValue
- Type: System..::..Double
The new elevation value.
Remarks
If none of the points in the collection doesn's exist, an exception will be thrown.
This function ignores input points that do not exist, unless all of the input points do not exist, which will result in an exception.
This applies to a TopographySurface element (not a SiteSubRegion or a topography surface associated with a BuildingPad), which shoule be in an active TopographyEditScope.
Exceptions
Exception | Condition |
---|---|
Autodesk.Revit.Exceptions..::..ArgumentException | There are no points in the input points set. |
Autodesk.Revit.Exceptions..::..ArgumentNullException | A non-optional argument was null |
Autodesk.Revit.Exceptions..::..ArgumentOutOfRangeException | The given value for elevationValue must be no more than 30000 feet in absolute value. |
Autodesk.Revit.Exceptions..::..InvalidOperationException | This element is not a TopographySurface. -or- The points of this topography surface are not editable. -or- The TopographySurface element is not in an active TopographyEditScope. Modification cannot be made on this TopographySurface. -or- None of the input points exists in the current TopographySurface. |
Autodesk.Revit.Exceptions..::..ModificationForbiddenException | The document containing this TopographySurface is in failure mode: an operation has failed, and Revit requires the user to either cancel the operation or fix the problem (usually by deleting certain elements). -or- The document containing this TopographySurface is being loaded, or is in the midst of another sensitive process. |
Autodesk.Revit.Exceptions..::..ModificationOutsideTransactionException | The document containing this TopographySurface has no open transaction. |