ConstructMarker(CIMColor,Double,SimpleMarkerStyle) Method

In This Topic

Constructs a marker of specific color, size and style. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Overloads Function ConstructMarker( _
   ByVal color As CIMColor, _
   ByVal size As Double, _
   ByVal markerStyle As SimpleMarkerStyle _
) As CIMMarker

public CIMMarker ConstructMarker( 
   CIMColor color,
   double size,
   SimpleMarkerStyle markerStyle
)

Parameters

color: ArcGIS.Core.CIM.CIMColor
size: The size of the marker to construct.
markerStyle: SimpleMarkerStyle

Return Value

ArcGIS.Core.CIM.CIMMarker

Exceptions

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

Example

How to construct a point symbol from a marker

{
    CIMMarker marker = SymbolFactory.Instance.ConstructMarker(ColorFactory.Instance.GreenRGB, 8.0, SimpleMarkerStyle.Pushpin);
    CIMPointSymbol pointSymbolFromMarker = SymbolFactory.Instance.ConstructPointSymbol(marker);
}

How to construct a multilayer line symbol with circle markers on the line ends

{
    //Note: Needs QueuedTask to run
    var lineStrokeRed = SymbolFactory.Instance.ConstructStroke(ColorFactory.Instance.RedRGB, 4.0);
    var markerCircle = SymbolFactory.Instance.ConstructMarker(ColorFactory.Instance.RedRGB, 12, SimpleMarkerStyle.Circle);
    markerCircle.MarkerPlacement = new CIMMarkerPlacementOnVertices()
    {
        AngleToLine = true,
        PlaceOnEndPoints = true,
        Offset = 0
    };
    var lineSymbolWithCircles = new CIMLineSymbol()
    {
        SymbolLayers = new CIMSymbolLayer[2] { markerCircle, lineStrokeRed }
    };
}

How to construct a multilayer line symbol with an arrow head on the end

{
      var markerTriangle = SymbolFactory.Instance.ConstructMarker(ColorFactory.Instance.RedRGB, 12, SimpleMarkerStyle.Triangle);
      markerTriangle.Rotation = -90; // or -90
      markerTriangle.MarkerPlacement = new CIMMarkerPlacementOnLine() { AngleToLine = true, RelativeTo = PlacementOnLineRelativeTo.LineEnd };

      var lineSymbolWithArrow = new CIMLineSymbol()
      {
          SymbolLayers = new CIMSymbolLayer[2] { markerTriangle,
          SymbolFactory.Instance.ConstructStroke(ColorFactory.Instance.RedRGB, 2)
}
      };
  }

Modify a point symbol created from a character marker

{
    //create marker from the Font, char index,size,color
    //Note: Needs QueuedTask to run
    var cimMarker = SymbolFactory.Instance.ConstructMarker(125, "Wingdings 3", "Regular", 6, ColorFactory.Instance.BlueRGB) as CIMCharacterMarker;
    var polygonMarker = cimMarker.Symbol;
    //modifying the polygon's outline and fill
    //This is the outline
    polygonMarker.SymbolLayers[0] = SymbolFactory.Instance.ConstructStroke(ColorFactory.Instance.GreenRGB, 2, SimpleLineStyle.Solid);
    //This is the fill
    polygonMarker.SymbolLayers[1] = SymbolFactory.Instance.ConstructSolidFill(ColorFactory.Instance.BlueRGB);
    //create a symbol from the marker 
    //Note this overload of ConstructPointSymbol does not need to be run within QueuedTask.Run.
    var pointSymbol = SymbolFactory.Instance.ConstructPointSymbol(cimMarker);
}

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

SymbolFactory Class
SymbolFactory Members
Overload List

Send feedback