ConstructPolygonSymbol(CIMFill,CIMStroke,CIMColor,SimpleStipplePattern) Method

In This Topic

Constructs a polygon symbol with a specific fill, stroke, and stipple pattern. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Overloads Function ConstructPolygonSymbol( _
   ByVal fill As CIMFill, _
   ByVal outline As CIMStroke, _
   ByVal color As CIMColor, _
   ByVal stipplePattern As SimpleStipplePattern _
) As CIMPolygonSymbol

public CIMPolygonSymbol ConstructPolygonSymbol( 
   CIMFill fill,
   CIMStroke outline,
   CIMColor color,
   SimpleStipplePattern stipplePattern
)

Parameters

fill
outline
color
stipplePattern

Return Value

ArcGIS.Core.CIM.CIMPolygonSymbol

Exceptions

Exception	Description
System.ArgumentNullException	Value cannot be null: color
ArcGIS.Core.CalledOnWrongThreadException	This method must be called within the lambda passed to QueuedTask.Run

Remarks

Specifying a null fill creates a stipple symbol with no background fill. Specifying a null stroke creates a stipple symbol with no outline. The stipple color is specified with "color". Note: the stipple pattern is generated with a marker not a fill.

Example

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");
}

Requirements

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

ArcGIS Pro version: 3.1 or higher.

Reference

SymbolFactory Class
SymbolFactory Members
Overload List

Send feedback