IProportionalSymbolRenderer Interface

Provides access to members that control the drawing of varying size symbols for each feature, each sized in proportion to a field value.

Product Availability

Members

	All Properties Methods	Description
	BackgroundSymbol	Background fill symbol used when proportional marker symbols are draw on polygon features.
	CreateLegendSymbols	Creates the legend. Call after all properties have been set.
	Field	Value field.
	FlanneryCompensation	Indicates if Flannery Compensation is applied.
	LegendSymbolCount	Number of symbols displayed in the TOC and legend.
	MaxDataValue	Normalized maximum data value.
	MinDataValue	Normalized minimum data value.
	MinSymbol	Symbol used to draw feature with the normalized minimum data value.
	NormField	Normalization field.
	ValueRepresentation	Representation type of the value field.
	ValueUnit	Units of the value field.

CoClasses that implement IProportionalSymbolRenderer

Remarks

You can use this interface to set up proportional symbol rendering for point, line, or area data. For example, if you have map tree locations as points, and an attribute reflecting the radius of the tree canopy, you can use proportional circles to depict the actual ground area covered by each tree.

If you have a feature layer of US States, you can create a population map of proportional marker symbols where there area of each symbol reflects the population for each state.

If you have a line layer representing rivers, you can symbolize these with line symbols with width proportional to the flow in each particular river line feature.

Known vs. Unknown Data Units

There are really two uses of proportional symbol rendering:

First, you can have a data field that represents an actual distance in the real world, such as the radius of a tree canopy in meters, or the width (actually diameter) of a water main in inches. In this case your units are known and you can use a ProportionalSymbolRenderer to draw a symbol on your map for each feature such that the area occupied by the feature on the map represents the actual area occupied in the real world.

Second, you may have a data field that represents a non-distance quantitiy, for example you might have county data and know the population of each county. This value does not represent a real world distance so the units are said to be unknown. In this case you can use the ProportionalSymbolRenderer to represent the relative population of each county. This is done by mapping a minimum symbol size, specified by MinSymbol, to the minimum data value of the population field. The MinSymbol is then scaled up proportionally based on the relative difference between the minimum population value and the value for a given county feature.

To learn more, see IProportionalSymbolRenderer::ValueUnit and IProportionalSymbolRenderer::ValueRepresentation.

.NET Samples