CreateGraphicElement(IElementContainer,Geometry,CIMSymbol,String,Boolean,ElementInfo) Method

In This Topic

Create a GraphicElement based on the input geometry and associated symbol and properties (optional).

Syntax

Visual Basic (Declaration)
C#

Overloads Function CreateGraphicElement( _
   ByVal elementContainer As IElementContainer, _
   ByVal geometry As Geometry, _
   Optional ByVal symbol As CIMSymbol, _
   Optional ByVal elementName As String, _
   Optional ByVal select As Boolean, _
   Optional ByVal elementInfo As ElementInfo _
) As GraphicElement

GraphicElement CreateGraphicElement( 
   IElementContainer elementContainer,
   Geometry geometry,
   CIMSymbol symbol,
   string elementName,
   bool select,
   ElementInfo elementInfo
)

Parameters

elementContainer: The parent element container
geometry: The geometry to be used for the graphic element
symbol: The symbol to be used for the graphic element (optional)
elementName: An element name (optional)
select: Select after create flag (default is true) (optional)
elementInfo: Additional element properties (optional)

Return Value

GraphicElement

Remarks

Use CreateGraphicElement(IElementContainer,CIMGraphic,String,Boolean,ElementInfo) if you are using a graphic previously created, eg via: GraphicFactory.CreateSimpleGraphic

Example

Create Graphic Element using CIMGraphic

{
  //Note: on the QueuedTask
  //Place symbol on the layout
  MapPoint location = MapPointBuilderEx.CreateMapPoint(new Coordinate2D(9, 1));

  //specify a symbol
  var pt_symbol = SymbolFactory.Instance.ConstructPointSymbol(
                        ColorFactory.Instance.GreenRGB);

  //create a CIMGraphic 
  var graphic = new CIMPointGraphic()
  {
    Symbol = pt_symbol.MakeSymbolReference(),
    Location = location //center of map
  };
  //Or use GraphicFactory
  var graphicFactory = GraphicFactory.Instance.CreateSimpleGraphic(location, pt_symbol);

  ElementFactory.Instance.CreateGraphicElement(layout, graphic);
  ElementFactory.Instance.CreateGraphicElement(layout, graphicFactory);
}

Create Graphic Element using CIMSymbol

{
  //Note: Must be on QueuedTask.Run
  //Place symbol on the layout
  MapPoint location = MapPointBuilderEx.CreateMapPoint(new Coordinate2D(9, 1));

  //specify a symbol
  var pt_symbol = SymbolFactory.Instance.ConstructPointSymbol(
                        ColorFactory.Instance.GreenRGB);

  ElementFactory.Instance.CreateGraphicElement(layout, location, pt_symbol);
}

Create Picture Graphic Element using CIMSymbol

{
  //Note: Must be on QueuedTask.Run(() => { ...

  //Build geometry
  Coordinate2D ll = new Coordinate2D(0.5, 1);
  Coordinate2D ur = new Coordinate2D(2.5, 2);
  Envelope env = EnvelopeBuilderEx.CreateEnvelope(ll, ur);

  //Create and add element to layout
  string picPath = System.IO.Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyPictures),
    "SamplePicture.jpg");
  var pic_gr = ElementFactory.Instance.CreatePictureGraphicElement(
    layout, env.Center, picPath, "New Picture", true, new ElementInfo() { Anchor = Anchor.CenterPoint });
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

IElementFactory Interface
IElementFactory Members
Overload List

Send feedback