CreateGraphicElements(ILayoutElementContainer,IEnumerable<CIMGraphic>,IEnumerable<IEnumerable<CIMStringMap>>,IEnumerable<String>) Method

Creates a graphic element on a layout or element container from a CIMGraphic. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public IList<GraphicElement> CreateGraphicElements( 
   ILayoutElementContainer elementContainer,
   IEnumerable<CIMGraphic> graphics,
   IEnumerable<IEnumerable<CIMStringMap>> customProperties,
   IEnumerable<string> elementNames
)

Public Overloads Function CreateGraphicElements( _
   ByVal elementContainer As ILayoutElementContainer, _
   ByVal graphics As IEnumerable(Of CIMGraphic), _
   ByVal customProperties As IEnumerable(Of IEnumerable(Of CIMStringMap)), _
   Optional ByVal elementNames As IEnumerable(Of String) _
) As IList(Of GraphicElement)

Parameters

elementContainer: Layout or GroupElement
graphics: CIMGraphic
customProperties: Custom properties or null
elementNames: The names of the elements or null.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method must be called within the lambda passed to QueuedTask.Run.
System.ArgumentNullException	graphic(s) cannot be null
System.ArgumentException	Number of elementNames does not match the number of graphics
System.ArgumentException	Number of customProperties does not match the number of graphics

Remarks

If the element container is a Layout then the element gets added to the root level of the layout TOC at the top most position. If the element container is a GroupElement then it gets added to the group at the topmost position.
If elementNames are provided then the number of elementNames must match the number of graphic elements.
Custom properties, if provided, must be serializable to string and the number of custom property collections must match the number of graphic elements.

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

LayoutElementFactory Class
LayoutElementFactory Members
Overload List