AddElements(GraphicsLayer,IEnumerable<CIMGraphic>,IEnumerable<IEnumerable<CIMStringMap>>) Method

Add a collection of ArcGIS.Desktop.Layouts.GraphicElement based on the list of ArcGIS.Core.CIM.CIMGraphic. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public static IList<GraphicElement> AddElements( 
   GraphicsLayer graphicsLayer,
   IEnumerable<CIMGraphic> graphics,
   IEnumerable<IEnumerable<CIMStringMap>> customProperties
)

Public Overloads Shared Function AddElements( _
   ByVal graphicsLayer As GraphicsLayer, _
   ByVal graphics As IEnumerable(Of CIMGraphic), _
   ByVal customProperties As IEnumerable(Of IEnumerable(Of CIMStringMap)) _
) As IList(Of GraphicElement)

Parameters

graphicsLayer
graphics: The collection of graphics to be added
customProperties: Custom properties or null

Return Value

IList

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.ArgumentException	The value cannot be null: graphics
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 map view displaying the graphics layer should be initialized.
o ArcGIS.Core.CIM.CIMInkGraphic is not supported
o ArcGIS.Core.CIM.CIMMultiPatchGraphic is not supported
Custom properties, if provided, must be serializable to string and must match the number of graphics.
The elements will not be selected after the add.

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

GraphicsLayerExtensions Class
GraphicsLayerExtensions Members
Overload List