SetElevation Method (IEnumerable(ObjectId), IEnumerable(Double))

Sets the elevation for multiple CogoPoints with different elevation values.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 13.3.1717.0

Syntax

C#

public ObjectIdCollection SetElevation(
	IEnumerable<ObjectId> pointIds,
	IEnumerable<double> elevations
)

Visual Basic

Public Function SetElevation ( _
	pointIds As IEnumerable(Of ObjectId), _
	elevations As IEnumerable(Of Double) _
) As ObjectIdCollection

Visual C++

public:
ObjectIdCollection^ SetElevation(
	IEnumerable<ObjectId>^ pointIds, 
	IEnumerable<double>^ elevations
)

Parameters

pointIds
Type: System.Collections.Generic.IEnumerable<ObjectId>
A sequence of ObjectIds for the points you want to set the elevation for.
elevations
Type: System.Collections.Generic.IEnumerable<Double>

Return Value

An ObjectIdCollection containing the CogoPoints which have their elevation set successfully.

Remarks

  • If you want to set to the state of "Has not beet set" for all the CogoPoints, set the elevation to Double.NaN.
  • If there are fewer elevations than points, only the first n points in the list will have their elevation set, where n is the number of elevations specified.

Examples

CopyC#
 1// _civildoc is the active CivilDocument instance.
 2// 
 3CogoPointCollection cogoPoints = _civildoc.CogoPoints;
 4ObjectId pointId = cogoPoints.Add(new Point3d(100, 100, 50));
 5
 6// set value for single point
 7if (cogoPoints.SetElevation(pointId, 125) == ObjectId.Null)
 8    write("SetElevation failed.\n");
 9
10Point3dCollection points = new Point3dCollection();
11points.Add(new Point3d(50, 50, 25));
12points.Add(new Point3d(200, 200, 15));
13ObjectIdCollection pointIds = cogoPoints.Add(points);
14List<ObjectId> pointIdList = GetListFromCollection(pointIds);
15
16// set multiple points to a single value
17ObjectIdCollection success = cogoPoints.SetElevation(pointIdList, 125);
18write(String.Format("SetElevation success for {0} of {1} points\n",
19   success.Count, pointIdList.Count));
20
21List<double> eastings = new List<double>();
22for (int i = 0; i < pointIdList.Count; i++)
23    eastings.Add(i * 10);
24
25// set multiple points to multiple values
26success = cogoPoints.SetElevation(pointIdList, eastings);
27write(String.Format("SetElevation success for {0} of {1} points\n",
28   success.Count, pointIdList.Count));
CopyVB.NET
 1' _civildoc is the active CivilDocument instance.
 2'
 3Dim cogoPoints As CogoPointCollection = _civildoc.CogoPoints
 4Dim pointId As ObjectId = cogoPoints.Add(New Point3d(100, 100, 50))
 5
 6' set value for single point
 7If cogoPoints.SetElevation(pointId, 125) = ObjectId.Null Then
 8    write("SetElevation failed." & vbLf)
 9End If
10
11Dim points As New Point3dCollection()
12points.Add(New Point3d(50, 50, 25))
13points.Add(New Point3d(200, 200, 15))
14Dim pointIds As ObjectIdCollection = cogoPoints.Add(points)
15Dim pointIdList As List(Of ObjectId) = GetListFromCollection(pointIds)
16
17' set multiple points to a single value
18Dim success As ObjectIdCollection = cogoPoints.SetElevation(pointIdList, 125)
19write([String].Format("SetElevation success for {0} of {1} points", success.Count, pointIdList.Count))
20
21Dim eastings As New List(Of Double)()
22For i As Integer = 0 To pointIdList.Count - 1
23    eastings.Add(i * 10)
24Next
25
26' set multiple points to multiple values
27success = cogoPoints.SetElevation(pointIdList, eastings)
28write([String].Format("SetElevation success for {0} of {1} points", success.Count, pointIdList.Count))

See Also