ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / SimpleRendererDefinition Class
Members Example

In This Topic
    SimpleRendererDefinition Class
    In This Topic
    Represents simple renderer definition to draw all features in a layer with a common symbol.
    Object Model
    SimpleRendererDefinition ClassCIMSymbolReference Class
    Syntax
    public class SimpleRendererDefinition : RendererDefinition 
    Public Class SimpleRendererDefinition 
       Inherits RendererDefinition
    Remarks
    Once you define a simple renderer, you can call a FeatureLayer's CreateRenderer and SetRenderer methods to create and assign a renderer to a feature layer.
    Example
    Create FeatureLayer with a Renderer
    {
      //Define a simple renderer to draw the Point US Cities feature class.
      var simpleRender = new SimpleRendererDefinition
      {
        SymbolTemplate = SymbolFactory.Instance.ConstructPointSymbol(ColorFactory.Instance.RedRGB, 4.0, SimpleMarkerStyle.Circle).MakeSymbolReference()
    
      };
      //The catalog path of the feature layer to add to the map
      var featureClassUri = new Uri(@"C:\Data\Admin\AdminData.gdb\USA\cities");
      //Define the Feature Layer's parameters.
      var layerParams = new FeatureLayerCreationParams(featureClassUri)
      {
        //Set visibility
        IsVisible = true,
        //Set Renderer
        RendererDefinition = simpleRender,
      };
      //Create the layer with the feature layer parameters and add it to the active map
      var createdFCWithRenderer = await QueuedTask.Run(() =>
        LayerFactory.Instance.CreateLayer<FeatureLayer>(layerParams, map));
    }
    Apply Symbology from a Layer in the TOC
    {
      await QueuedTask.Run(() =>
      {
        if (map == null)
        {
          return;
        }
    
      //Get an existing Layer. This layer has a symbol you want to use in a new layer.
      var lyr = map.GetLayersAsFlattenedList().OfType<FeatureLayer>()
            .Where(l => l.ShapeType == esriGeometryType.esriGeometryPoint).FirstOrDefault();
      //This is the renderer to use in the new Layer
      var renderer = lyr.GetRenderer() as CIMSimpleRenderer;
      //Set the DataConnection for the new layer
      Geodatabase geodatabase = new Geodatabase(
        new FileGeodatabaseConnectionPath(new Uri(@"E:\Data\Admin\AdminData.gdb")));
      FeatureClass featureClass = geodatabase.OpenDataset<FeatureClass>("Cities");
      var dataConnection = featureClass.GetDataConnection();
      //Create the definition for the new feature layer
      var featureLayerParams = new FeatureLayerCreationParams(dataConnection)
      {
        RendererDefinition = new SimpleRendererDefinition(renderer.Symbol),
        IsVisible = true,
      };
      //create the new layer
        LayerFactory.Instance.CreateLayer<FeatureLayer>(
          featureLayerParams, map);
      });
    }
    Create a stream layer with a simple renderer
    {
      await QueuedTask.Run(() =>
      {
        var url = @"https://geoeventsample1.esri.com:6443/arcgis/rest/services/LABus/StreamServer";
        var uri = new Uri(url, UriKind.Absolute);
        var createParams = new FeatureLayerCreationParams(uri)
        {
          RendererDefinition = new SimpleRendererDefinition()
          {
            SymbolTemplate = SymbolFactory.Instance.ConstructPointSymbol(
                                ColorFactory.Instance.BlueRGB,
                                12,
                         SimpleMarkerStyle.Pushpin).MakeSymbolReference()
          }
        };
        streamLayer = LayerFactory.Instance.CreateLayer<StreamLayer>(
                            createParams, map);
      });
    }
    Inheritance Hierarchy

    System.Object
       ArcGIS.Desktop.Mapping.LayerDrawingDefinition
          ArcGIS.Desktop.Mapping.RendererDefinition
             ArcGIS.Desktop.Mapping.SimpleRendererDefinition

    Requirements

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

    ArcGIS Pro version: 3.0 or higher.
    See Also