ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Desktop.Layouts Namespace / IGraphicFactory Interface / CreateSimpleGraphic Method
The geometry for the resulting graphic
The symbol to be used with the graphic (optional)
Example

In This Topic
    CreateSimpleGraphic Method (IGraphicFactory)
    In This Topic
    Creates a point, line, polygon or text graphic based on the input geometry and symbol.
    Syntax
    CIMGraphic CreateSimpleGraphic( 
       Geometry geometry,
       CIMSymbol symbol
    )
    Function CreateSimpleGraphic( _
       ByVal geometry As Geometry, _
       Optional ByVal symbol As CIMSymbol _
    ) As CIMGraphic

    Parameters

    geometry
    The geometry for the resulting graphic
    symbol
    The symbol to be used with the graphic (optional)

    Return Value

    Example
    Create Circle Graphic
    {
      await QueuedTask.Run(() =>
      {
    
      //Build geometry
      Coordinate2D center = new Coordinate2D(2, 4);
      EllipticArcSegment circle_seg = EllipticArcBuilderEx.CreateCircle(
        new Coordinate2D(2, 4), 0.5, ArcOrientation.ArcClockwise, null);
      var circle_poly = PolygonBuilderEx.CreatePolygon(PolylineBuilderEx.CreatePolyline(circle_seg));
    
      //PolylineBuilderEx.CreatePolyline(cir, AttributeFlags.AllAttributes));
      //Set symbology, create and add element to layout
      CIMStroke outline = SymbolFactory.Instance.ConstructStroke(
        ColorFactory.Instance.BlackRGB, 2.0, SimpleLineStyle.Dash);
    
      CIMPolygonSymbol circleSym = SymbolFactory.Instance.ConstructPolygonSymbol(
        ColorFactory.Instance.RedRGB, SimpleFillStyle.Solid, outline);
      SymbolFactory.Instance.ConstructPolygonSymbol(null,
        SymbolFactory.Instance.ConstructStroke(ColorFactory.Instance.RedRGB, 2));
    
      var circleGraphic = GraphicFactory.Instance.CreateSimpleGraphic(circle_poly, circleSym);
    
      //Make an element to add to GraphicsLayer or Layout
      //var elemInfo = new ElementInfo() { Anchor = Anchor.CenterPoint };
      //GraphicElement cirElm = ElementFactory.Instance.CreateGraphicElement(
        //  layout, circleGraphic, "New Circle", true, elemInfo);
      });
    }
    Get Graphic Outline
    {
      //given a graphic, extract its outline geometry
      var graphic_outline = GraphicFactory.Instance.GetGraphicOutline(
                            layout, cimGraphic);
      //TODO - use the geometry - eg, make another graphic
      var outline_graphic = GraphicFactory.Instance.CreateSimpleGraphic(graphic_outline);
      //... etc.
    }
    Create Point Element
    {
      var project = Project.Current;
      await QueuedTask.Run(() =>
      {
    
      //Build geometry
      Coordinate2D coord2D = new Coordinate2D(2.0, 10.0);
    
      //Reference a point symbol in a style
      StyleProjectItem stylePrjItm = project.GetItems<StyleProjectItem>()
                .FirstOrDefault(item => item.Name == "ArcGIS 2D");
      SymbolStyleItem symStyleItm = stylePrjItm.SearchSymbols(
                            StyleItemType.PointSymbol, "City Hall")[0];
      CIMPointSymbol pointSym = symStyleItm.Symbol as CIMPointSymbol;
      pointSym.SetSize(50);
    
      var elemInfo = new ElementInfo()
      {
        CustomProperties = new List<CIMStringMap>() {
        new CIMStringMap() { Key = "Key1", Value = "Value1"},
        new CIMStringMap() { Key = "Key2", Value = "Value2"}
      },
        Anchor = Anchor.TopRightCorner,
        Rotation = 45.0
      };
    
      var graphic = GraphicFactory.Instance.CreateSimpleGraphic(
                                    coord2D.ToMapPoint(), pointSym);
    
      ElementFactory.Instance.CreateGraphicElement(
        layout, graphic, "New Point", true, elemInfo);
      });
    }
    Create Rectangle Element
    {
      await QueuedTask.Run(() =>
      {
    
      //Build geometry
      Coordinate2D ll = new Coordinate2D(1.0, 4.75);
      Coordinate2D ur = new Coordinate2D(3.0, 5.75);
      Envelope env = EnvelopeBuilderEx.CreateEnvelope(ll, ur);
    
      //Set symbology, create and add element to layout
      CIMStroke outline = SymbolFactory.Instance.ConstructStroke(
        ColorFactory.Instance.BlackRGB, 5.0, SimpleLineStyle.Solid);
      CIMPolygonSymbol polySym = SymbolFactory.Instance.ConstructPolygonSymbol(
        ColorFactory.Instance.GreenRGB, SimpleFillStyle.DiagonalCross, outline);
    
      var ge = GraphicFactory.Instance.CreateSimpleGraphic(env, polySym);
      var elemInfo = new ElementInfo()
      {
        Anchor = Anchor.CenterPoint,
        Rotation = 45.0,
        CornerRounding = 5.0
      };
    
      ElementFactory.Instance.CreateGraphicElement(
        layout, env, polySym, "New Rectangle", false, elemInfo);
      });
    }
    Create Graphic Elements
    {
      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 = PolygonBuilderEx.CreatePolygon(plyCoords);
    
      //Build geometry
      Coordinate2D ll = new Coordinate2D(1.0, 4.75);
      Coordinate2D ur = new Coordinate2D(3.0, 5.75);
      Envelope env = EnvelopeBuilderEx.CreateEnvelope(ll, ur);
    
      //Build geometry
      Coordinate2D coord2D = new Coordinate2D(2.0, 10.0);
    
      var g1 = GraphicFactory.Instance.CreateSimpleGraphic(poly);
      var g2 = GraphicFactory.Instance.CreateSimpleGraphic(env);
      var g3 = GraphicFactory.Instance.CreateSimpleGraphic(coord2D.ToMapPoint());
    
      var ge = ElementFactory.Instance.CreateGraphicElements(
        layout, new List<CIMGraphic>() { g1, g2, g3 },
        new List<string>() { "Poly", "Envelope", "MapPoint" },
        true);
      });
    }
    Create Graphic Element using CIMGraphic
    {
      await 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);
    
      //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);
      });
    }
    Bulk Element creation
    {
      await QueuedTask.Run(() =>
      {
    
      //List of Point graphics
      var listGraphics = new List<CIMPointGraphic>();
      var listGraphicsFactory = new List<CIMPointGraphic>();
      //Symbol
      var pointSymbol = SymbolFactory.Instance.ConstructPointSymbol(
                                          ColorFactory.Instance.BlackRGB);
      //Define size of the array
      int dx = 5;
      int dy = 5;
      MapPoint point = null;
      //Create the List of graphics for the array
      for (int row = 0; row <= dx; ++row)
      {
        for (int col = 0; col <= dy; ++col)
        {
          point = MapPointBuilderEx.CreateMapPoint(col, row);
          //create a CIMGraphic
          var graphic = new CIMPointGraphic()
          {
            Symbol = pointSymbol.MakeSymbolReference(),
            Location = point
          };
          listGraphics.Add(graphic);
          //Or use GraphicFactory
          var graphicFactory = GraphicFactory.Instance.CreateSimpleGraphic(
                                        point, pointSymbol) as CIMPointGraphic;
          listGraphicsFactory.Add(graphicFactory);
        }
      }
      //Draw the array of graphics
    
      var bulkgraphics = ElementFactory.Instance.CreateGraphicElements(
                                                         layout, listGraphics);
      var bulkgraphicsFactory = ElementFactory.Instance.CreateGraphicElements(
                                                         layout, listGraphicsFactory);
      });
    }
    Translates a point in map coordinates to a point in page coordinates
    {
      var pointSymbol = SymbolFactory.Instance.ConstructPointSymbol(ColorFactory.Instance.BlackRGB, 8);
      var activeMapView = MapView.Active;
      //Convert the clicked point in client coordinates to the corresponding map coordinates.
      //clicked point can be from a Map Tool's HandleMouseDownAsync callback.
      //MapViewMouseButtonEventArgs ClientPoint property.
      Point clickedPoint = new Point();
      await QueuedTask.Run(() =>
      {
        var clickedMapPoint = activeMapView.ClientToMap(clickedPoint);
        //Get the corresponding layout point
        var pointOnLayoutFrame = mapFrame.MapToPage(mapPoint);
    
        //Create a point graphic on the Layout.
        var cimGraphicElement = new CIMPointGraphic
        {
          Location = pointOnLayoutFrame,
          Symbol = pointSymbol.MakeSymbolReference()
        };
        //Or use GraphicFactory
        var cimGraphicElement2 = GraphicFactory.Instance.CreateSimpleGraphic(
                pointOnLayoutFrame, pointSymbol);
    
        ElementFactory.Instance.CreateGraphicElement(layout, cimGraphicElement);
        ElementFactory.Instance.CreateGraphicElement(layout, cimGraphicElement2);
      });
      ArcGIS.Desktop.Framework.Dialogs.MessageBox.Show(string.Format("X: {0} Y: {1} Z: {2}",
          mapPoint.X, mapPoint.Y, mapPoint.Z), "Map Coordinates");
    }
    Requirements

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

    ArcGIS Pro version: 3.0 or higher.
    See Also