CogoPointCollection.SetDescriptionFormat(ObjectId, String) Method

Sets the DescriptionFormat property for a single CogoPoint.

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

Syntax

C#

public ObjectId SetDescriptionFormat(
	ObjectId pointId,
	string descFormat
)

VB

Public Function SetDescriptionFormat ( 
	pointId As ObjectId,
	descFormat As String
) As ObjectId

C++

public:
ObjectId SetDescriptionFormat(
	ObjectId pointId, 
	String^ descFormat
)

Parameters

pointId  ObjectId

The ObjectId of the point you want to set the DescriptionFormat property for.

descFormat  String

The new DescriptionFormat value.

Return Value

ObjectId
If the method succeeds, it returns the same ObjectId pointId passed in. If the method fails, it returns ObjectId.Null.

Example

C#

 1// _civildoc is the active CivilDocument instance.
 2// 
 3CogoPointCollection cogoPoints = _civildoc.CogoPoints;
 4ObjectId pointId = cogoPoints.Add(new Point3d(100, 100, 50), false);
 5String descriptionFormat = "$*";
 6
 7// set for single point
 8if (cogoPoints.SetDescriptionFormat(pointId, descriptionFormat) == ObjectId.Null)
 9    write("SetDescriptionFormat failed.\n");
10
11Point3dCollection points = new Point3dCollection();
12points.Add(new Point3d(50, 50, 25));
13points.Add(new Point3d(200, 200, 15));
14ObjectIdCollection pointIds = cogoPoints.Add(points, false);
15List<ObjectId> pointIdList = GetListFromCollection(pointIds);
16
17// set multiple points to a single description
18ObjectIdCollection success = cogoPoints.SetDescriptionFormat(pointIdList, descriptionFormat);
19write(String.Format("SetDescriptionFormat success for {0} of {1} points\n",
20   success.Count, pointIdList.Count));
21
22List<string> descriptions = new List<string>();
23for (int i = 0; i < pointIdList.Count; i++)
24    descriptions.Add(descriptionFormat + " " + i);
25
26// set multiple points to multiple descriptions
27success = cogoPoints.SetDescriptionFormat(pointIdList, descriptions);
28write(String.Format("SetDescriptionFormat success for {0} of {1} points\n",
29   success.Count, pointIdList.Count));

VB

 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), False)
 5Dim descriptionFormat As [String] = "$*"
 6
 7' set for single point
 8If cogoPoints.SetDescriptionFormat(pointId, descriptionFormat) = ObjectId.Null Then
 9    write("SetDescriptionFormat failed." & vbLf)
10End If
11
12Dim points As New Point3dCollection()
13points.Add(New Point3d(50, 50, 25))
14points.Add(New Point3d(200, 200, 15))
15Dim pointIds As ObjectIdCollection = cogoPoints.Add(points, False)
16Dim pointIdList As List(Of ObjectId) = GetListFromCollection(pointIds)
17
18' set multiple points to a single description
19Dim success As ObjectIdCollection = cogoPoints.SetDescriptionFormat(pointIdList, descriptionFormat)
20write([String].Format("SetDescriptionFormat success for {0} of {1} points", success.Count, pointIdList.Count))
21
22Dim descriptions As New List(Of String)()
23For i As Integer = 0 To pointIdList.Count - 1
24    descriptions.Add(descriptionFormat & " " & i)
25Next
26
27' set multiple points to multiple descriptions
28success = cogoPoints.SetDescriptionFormat(pointIdList, descriptions)
29write([String].Format("SetDescriptionFormat success for {0} of {1} points", success.Count, pointIdList.Count))

See Also

Reference