CreatePolygonGraphicElement(ILayoutElementContainer,Polygon,CIMPolygonSymbol) Method

Creates a graphic polygon element on a layout from a single polygon geometry. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

GraphicElement CreatePolygonGraphicElement( 
   ILayoutElementContainer elementContainer,
   Polygon polygon,
   CIMPolygonSymbol polygonSymbol
)

Overloads Function CreatePolygonGraphicElement( _
   ByVal elementContainer As ILayoutElementContainer, _
   ByVal polygon As Polygon, _
   Optional ByVal polygonSymbol As CIMPolygonSymbol _
) As GraphicElement

Parameters

elementContainer: Layout or GroupElement
polygon: Polygon
polygonSymbol: CIMPolygonSymbol

Return Value

Returns a GraphicElement.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.

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.

Example

//Create a polygon graphic with simple line and fill styles.

//Construct on the worker thread
await QueuedTask.Run(() =>
{
  //Build geometry
  List<Coordinate2D> plyCoords = new List<Coordinate2D>();
  plyCoords.Add(new Coordinate2D(1, 7));
  plyCoords.Add(new Coordinate2D(2, 7));
  plyCoords.Add(new Coordinate2D(2, 6.7));
  plyCoords.Add(new Coordinate2D(3, 6.7));
  plyCoords.Add(new Coordinate2D(3, 6.1));
  plyCoords.Add(new Coordinate2D(1, 6.1));
  Polygon poly = PolygonBuilder.CreatePolygon(plyCoords);

  //Set symbolology, create and add element to layout
  CIMStroke outline = SymbolFactory.Instance.ConstructStroke(ColorFactory.Instance.BlueRGB, 2.0, SimpleLineStyle.DashDotDot);
  CIMPolygonSymbol polySym = SymbolFactory.Instance.ConstructPolygonSymbol(ColorFactory.Instance.RedRGB, SimpleFillStyle.ForwardDiagonal, outline);
  GraphicElement polyElm = LayoutElementFactory.Instance.CreatePolygonGraphicElement(layout, poly, polySym);
  polyElm.SetName("New Polygon");
});

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

IElementFactory Interface
IElementFactory Members
Overload List