CIMPolygonSymbol Class

In This Topic

Represents a polygon symbol which is used to draw polygon features or polygon graphics.

Object Model

Syntax

Visual Basic (Declaration)
C#

Public Class CIMPolygonSymbol 
   Inherits CIMMultiLayerSymbol
   Implements System.ComponentModel.INotifyPropertyChanged, System.Xml.Serialization.IXmlSerializable

public class CIMPolygonSymbol : CIMMultiLayerSymbol, System.ComponentModel.INotifyPropertyChanged, System.Xml.Serialization.IXmlSerializable

Example

Create Ellipse Graphic Element

{
  //Note: Must be on QueuedTask.Run

  //Build geometry
  Coordinate2D center = new Coordinate2D(2, 2.75);
  var eabElp = new EllipticArcBuilderEx(center, 0, 1, 0.45,
                                      ArcOrientation.ArcClockwise);
  var ellipse = eabElp.ToSegment();

  //Set symbology, create and add element to layout
  CIMStroke outline = SymbolFactory.Instance.ConstructStroke(
                                  ColorFactory.Instance.GreenRGB, 2.0,
                          SimpleLineStyle.Dot);
  CIMPolygonSymbol ellipseSym = SymbolFactory.Instance.ConstructPolygonSymbol(
                            ColorFactory.Instance.GreyRGB, SimpleFillStyle.Vertical,
                                                    outline);

  var poly = PolygonBuilderEx.CreatePolygon(
    PolylineBuilderEx.CreatePolyline(ellipse, AttributeFlags.AllAttributes));

  var elpElm = ElementFactory.Instance.CreateGraphicElement(
    layout, poly, ellipseSym, "New Ellipse");
}

Create Lasso Polygon, Freehand Element

{
  //Note: Must be on QueuedTask.Run

  List<Coordinate2D> plyCoords = new List<Coordinate2D>();
  plyCoords.Add(new Coordinate2D(1, 1));
  plyCoords.Add(new Coordinate2D(1.25, 2));
  plyCoords.Add(new Coordinate2D(1.5, 1.1));
  plyCoords.Add(new Coordinate2D(1.75, 2));
  plyCoords.Add(new Coordinate2D(2, 1.1));
  plyCoords.Add(new Coordinate2D(2.25, 2));
  plyCoords.Add(new Coordinate2D(2.5, 1.1));
  plyCoords.Add(new Coordinate2D(2.75, 2));
  plyCoords.Add(new Coordinate2D(3, 1));
  Polygon poly = PolygonBuilderEx.CreatePolygon(plyCoords);

  //Set symbology, create and add element to layout
  CIMStroke outline = SymbolFactory.Instance.ConstructStroke(
              ColorFactory.Instance.BlackRGB, 2.0, SimpleLineStyle.Solid);
  CIMPolygonSymbol polySym = SymbolFactory.Instance.ConstructPolygonSymbol(
           ColorFactory.Instance.RedRGB, SimpleFillStyle.ForwardDiagonal, outline);

  ElementFactory.Instance.CreateGraphicElement(
    layout, poly, polySym, "New Lasso");
}

Create Polygon Element

{
  //Note: Must be on 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);

  //Set symbology, 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);

  ElementFactory.Instance.CreateGraphicElement(
    layout, poly, polySym, "New Polygon", false);
}

Create rectangle graphic with simple symbology

{
  //Create a simple 2D rectangle graphic and apply simple fill and
  //outline symbols.

  //Note: Must be on QueuedTask.Run

  //Build 2D envelope geometry
  Coordinate2D rec_ll = new Coordinate2D(1.0, 4.75);
  Coordinate2D rec_ur = new Coordinate2D(3.0, 5.75);

  Envelope rec_env = EnvelopeBuilderEx.CreateEnvelope(rec_ll, rec_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);


  GraphicElement recElm = ElementFactory.Instance.CreateGraphicElement(
    layout, rec_env, polySym, "New Rectangle");
  //Or use Predefined shape
  GraphicElement recElm2 = ElementFactory.Instance.CreatePredefinedShapeGraphicElement(
                            layout, PredefinedShape.Rectangle, rec_env, polySym,
                            "New Rectangle2");
}

How to construct a polygon symbol of specific color and fill style

{
    CIMPolygonSymbol polygonSymbol = SymbolFactory.Instance.ConstructPolygonSymbol(ColorFactory.Instance.RedRGB, SimpleFillStyle.Solid);
}

How to construct a polygon symbol of specific color, fill style and outline

{
    CIMStroke outline = SymbolFactory.Instance.ConstructStroke(ColorFactory.Instance.BlueRGB, 2.0, SimpleLineStyle.Solid);
    CIMPolygonSymbol fillWithOutline = SymbolFactory.Instance.ConstructPolygonSymbol(ColorFactory.Instance.RedRGB, SimpleFillStyle.Solid, outline);
}

How to construct a polygon symbol without an outline

{
    CIMPolygonSymbol fillWithoutOutline = SymbolFactory.Instance.ConstructPolygonSymbol(ColorFactory.Instance.RedRGB, SimpleFillStyle.Solid, null);
}

Cross hatch

/// <summary>
/// Create a polygon symbol using the ConstructHatchFill method . <br/>
/// ![PolygonSymbolDiagonalCrossHatch](https://ArcGIS.github.io/arcgis-pro-sdk/images/Symbology/ConstructHatchFill.png)
/// </summary>
{
  CIMStroke lineStroke = SymbolFactory.Instance.ConstructStroke(CIMColor.CreateRGBColor(51, 51, 51, 60), 4, SimpleLineStyle.Solid);
  //gradient
  var hatchFill = SymbolFactory.Instance.ConstructHatchFill(lineStroke, 45, 6, 0);

  List<CIMSymbolLayer> symbolLayers = new()
  {
    hatchFill
  };
  //This is the polygon symbol with a diagonal cross hatch fill
  CIMPolygonSymbol crossHatchPolygonSymbol = new CIMPolygonSymbol() { SymbolLayers = symbolLayers.ToArray() };
  //To apply the symbol to a polygon feature layer
  //var renderer = theLayer.GetRenderer() as CIMSimpleRenderer;
  //renderer.Symbol = crossHatchPolygonSymbol.MakeSymbolReference();
  //theLayer.SetRenderer(renderer);
}

Dash dot fill

/// <summary>
/// Create a polygon symbol with a dash dot fill. <br/>
/// ![PolygonSymbolDashDot](https://ArcGIS.github.io/arcgis-pro-sdk/images/Symbology/polygon-dash-dot.png)
/// </summary>
{
  //Note: Run withing QueuedTask
  var trans = 50.0;//semi transparent
  CIMStroke outline = SymbolFactory.Instance.ConstructStroke(CIMColor.CreateRGBColor(0, 0, 0, trans), 2.0, SimpleLineStyle.Solid);

  //Stroke for the fill            
  var dashDot = SymbolFactory.Instance.ConstructStroke(ColorFactory.Instance.RedRGB, 1.0, SimpleLineStyle.DashDotDot);
  //Mimic cross hatch
  CIMFill[] solidColorHatch =
        {

           new CIMHatchFill()
          {
              Enable = true,
              Rotation = 0.0,
              Separation = 2.5,
              LineSymbol = new CIMLineSymbol(){SymbolLayers = new CIMSymbolLayer[1] {dashDot } }
          },
           new CIMSolidFill()
          {
              Enable = true,
              Color = ColorFactory.Instance.CreateRGBColor(255, 255, 0)
          },
};
  List<CIMSymbolLayer> symbolLayers = [outline, .. solidColorHatch];
  //This is the polygon symbol with a dash dot fill
  CIMPolygonSymbol dashDotFillPolygon = new CIMPolygonSymbol() { SymbolLayers = symbolLayers.ToArray() };
  //To apply the symbol to a polygon feature layer
  //var renderer = theLayer.GetRenderer() as CIMSimpleRenderer;
  //renderer.Symbol = dashDotFillPolygon.MakeSymbolReference();
  //theLayer.SetRenderer(renderer);
}

Inheritance Hierarchy

System.Object
   ArcGIS.Core.CIM.CIMObject
      ArcGIS.Core.CIM.CIMSymbol
         ArcGIS.Core.CIM.CIMMultiLayerSymbol
            ArcGIS.Core.CIM.CIMPolygonSymbol

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

CIMPolygonSymbol Members
ArcGIS.Core.CIM Namespace

Send feedback