GraduatedSymbolsRendererDefinition Class

In This Topic

Represents graduated symbol renderer definition to show qualitative differences in feature values with varying symbol sizes.

Object Model

Syntax

Visual Basic (Declaration)
C#

Public Class GraduatedSymbolsRendererDefinition 
   Inherits ClassBreaksRendererDefinition

public class GraduatedSymbolsRendererDefinition : ClassBreaksRendererDefinition

Remarks

GraduatedSymbolsRendererDefinition class allow you to define parameters to create renderers to draw features with symbols with graduated size determined based on the values of a quantitative attribute that is statistically grouped by a classification algorithm.
Once you define a graduated symbol renderer, you can call a FeatureLayer's CreateRenderer and SetRenderer methods to create and assign a renderer to a feature layer.

Example

Class Breaks renderer with graduated symbols.

/// <summary>
/// Renders a feature layer using graduated symbols and natural breaks to draw quantities.
/// ![cb-symbols.png](https://ArcGIS.github.io/arcgis-pro-sdk/images/Renderers/cb-symbols.png "Graduated symbols with natural breaks renderer.")
/// </summary>
{
  //Check feature layer name
  //Code works with the USDemographics feature layer available with the ArcGIS Pro SDK Sample data
  var featureLayer = MapView.Active.Map.GetLayersAsFlattenedList().OfType<FeatureLayer>().FirstOrDefault(f => f.Name == "USDemographics");
  if (featureLayer == null)
  {
    MessageBox.Show("This renderer works with the USDemographics feature layer available with the ArcGIS Pro SDK Sample data", "Data missing");
  }
  GraduatedSymbolsRendererDefinition gsDef = new GraduatedSymbolsRendererDefinition()
  {
    ClassificationField = "NumericFieldInFeatureLayer", //getting the first numeric field
    ClassificationMethod = ClassificationMethod.NaturalBreaks,
    SymbolTemplate = SymbolFactory.Instance.ConstructPointSymbol(CIMColor.CreateRGBColor(76, 230, 0)).MakeSymbolReference(),
    MinimumSymbolSize = 4,
    MaximumSymbolSize = 50,
    BreakCount = 5,
    ColorRamp = colorRamp, //getting a color ramp
  };
  //Note: Run within QueuedTask
  CIMClassBreaksRenderer renderer = (CIMClassBreaksRenderer)featureLayer.CreateRenderer(gsDef);
  featureLayer?.SetRenderer(renderer);
}

Inheritance Hierarchy

System.Object
   ArcGIS.Desktop.Mapping.LayerDrawingDefinition
      ArcGIS.Desktop.Mapping.RendererDefinition
         ArcGIS.Desktop.Mapping.ClassBreaksRendererDefinition
            ArcGIS.Desktop.Mapping.GraduatedSymbolsRendererDefinition

Requirements

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

ArcGIS Pro version: 3.0 or higher.

Reference

GraduatedSymbolsRendererDefinition Members
ArcGIS.Desktop.Mapping Namespace

Send feedback