AddElement(GraphicsLayer,Geometry,IEnumerable<CIMStringMap>,CIMSymbol) Method

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

Syntax

C#
Visual Basic (Declaration)

public static GraphicElement AddElement( 
   GraphicsLayer graphicsLayer,
   Geometry geometry,
   IEnumerable<CIMStringMap> customProperties,
   CIMSymbol symbol
)

Public Overloads Shared Function AddElement( _
   ByVal graphicsLayer As GraphicsLayer, _
   ByVal geometry As Geometry, _
   ByVal customProperties As IEnumerable(Of CIMStringMap), _
   Optional ByVal symbol As CIMSymbol _
) As GraphicElement

Parameters

graphicsLayer
geometry: The geometry to be used for the graphic element
customProperties: Custom properties or null
symbol: The symbol to be used for the graphic element. 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	geometry cannot be null or empty
System.ArgumentException	symbol is not a CIMPointSymbol \| CIMLineSymbol \| CIMPolygonSymbol
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

Multipatch geometry is not currently supported.
The geometry cannot be empty or null. Providing the wrong symbol type for the given geometry will result in an System.ArgumentException. If symbol is null a default symbol of the correct type will be 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 11, Windows 10, Windows 8.1

Reference

GraphicsLayerExtensions Class
GraphicsLayerExtensions Members
Overload List