AddElement(GraphicsLayer,MapPoint,String,IEnumerable<CIMStringMap>,CIMTextSymbol) Method

Add a ArcGIS.Desktop.Layouts.GraphicElement based on the input point, text, and textsymbol (optional). This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public static GraphicElement AddElement( 
   GraphicsLayer graphicsLayer,
   MapPoint point,
   string text,
   IEnumerable<CIMStringMap> customProperties,
   CIMTextSymbol textSymbol
)

Public Overloads Shared Function AddElement( _
   ByVal graphicsLayer As GraphicsLayer, _
   ByVal point As MapPoint, _
   ByVal text As String, _
   ByVal customProperties As IEnumerable(Of CIMStringMap), _
   Optional ByVal textSymbol As CIMTextSymbol _
) As GraphicElement

Parameters

graphicsLayer
point: The text placement point
text: The text string
customProperties: Custom properties or null
textSymbol: The text symbol. Can be null

Return Value

ArcGIS.Desktop.Layouts.GraphicElement

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentException	point cannot be null or empty
System.InvalidOperationException	Map has reached maximum graphics count limit of 4000 elements. One or more elements cannot be created.
System.InvalidOperationException	Map has reached maximum graphics size limit of 10 MB. One or more elements cannot be created.

Remarks

The point cannot be null or empty. If text is null an empty string is assigned. If textSymbol is null a default text symbol is assigned.
The map view displaying the graphics layer should be initialized.
Custom properties, if provided, must be serializable to string.
The element will be selected after the add.

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

GraphicsLayerExtensions Class
GraphicsLayerExtensions Members
Overload List