CreateGraphicElement(ILayoutElementContainer,Geometry,IEnumerable<CIMStringMap>,CIMSymbol,String) Method

Create a 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 GraphicElement CreateGraphicElement( 
   ILayoutElementContainer elementContainer,
   Geometry geometry,
   IEnumerable<CIMStringMap> customProperties,
   CIMSymbol symbol,
   string elementName
)

Public Overloads Function CreateGraphicElement( _
   ByVal elementContainer As ILayoutElementContainer, _
   ByVal geometry As Geometry, _
   ByVal customProperties As IEnumerable(Of CIMStringMap), _
   Optional ByVal symbol As CIMSymbol, _
   Optional ByVal elementName As String _
) As GraphicElement

Parameters

elementContainer: Layout or GroupElement
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
elementName: An element name (optional)

Return Value

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

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.
Custom properties, if provided, must be serializable to string.
Use LayoutElementFactory for additional creation options of page layout elements

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

LayoutElementFactory Class
LayoutElementFactory Members
Overload List