ChoroplethColorizer.ValueProvider Property

Provides values from the data source (Shapefile or KML file) to color map shapes according to data.

Namespace: DevExpress.Xpf.Map

Assembly: DevExpress.Xpf.Map.v18.2.dll

Declaration

C#

public IColorizerValueProvider ValueProvider { get; set; }

VB.NET

Public Property ValueProvider As IColorizerValueProvider

Property Value

Type	Description
IColorizerValueProvider	An object that implements the IColorizerValueProvider interface.

Example

This example demonstrates how to paint each map contour in a specific color, based on population data from the Shapefile.

To do this, create a colorizer and assign it to the VectorLayer.Colorizer property.

To access GDP information from Shapefiles, assign a ShapeAttributeValueProvider object with the specified attribute name (NamedAttributeProviderBase.AttributeName) to the ChoroplethColorizer.ValueProvider property.

Then, specify range stops (data splits in ranges) for the colorizer using the ChoroplethColorizer.RangeStops property.

Finally, add the desired set of colors to the ColorCollection object that is accessed using the MapColorizer.Colors property. The colorizer automatically associates each color with the specified data range to colorize map shapes.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-colorize-map-contours-loaded-from-shapefiles-using-the-choropleth-colorizer-e4587.

MainWindow.xaml

<dxm:VectorLayer.Colorizer>
    <dxm:ChoroplethColorizer RangeStops="0 3000 10000 18000 28000 44000 82000 185000 1000000 2500000 15000000">
        <dxm:ChoroplethColorizer.ValueProvider>
            <dxm:ShapeAttributeValueProvider AttributeName="GDP_MD_EST"/>
        </dxm:ChoroplethColorizer.ValueProvider>
        <dxm:ChoroplethColorizer.Colors>
            <Color>#5F8B95</Color>
            <Color>#799689</Color>
            <Color>#A2A875</Color>
            <Color>#CEBB5F</Color>
            <Color>#F2CB4E</Color>
            <Color>#F1C149</Color>
            <Color>#E5A84D</Color>
            <Color>#D6864E</Color>
            <Color>#C56450</Color>
            <Color>#BA4D51</Color>
        </dxm:ChoroplethColorizer.Colors>
    </dxm:ChoroplethColorizer>
</dxm:VectorLayer.Colorizer>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ValueProvider property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-customize-a-choropleth-colorizers-range-distribution-t199939/CS/RangeDistributions/MainWindow.xaml#L31

                     RangeStops="0 3000 10000 18000 28000 44000 82000 185000 1000000 2500000 15000000">
<dxm:ChoroplethColorizer.ValueProvider>
    <dxm:ShapeAttributeValueProvider AttributeName="GDP_MD_EST"/>

how-to-colorize-map-contours-loaded-from-shapefiles-using-the-choropleth-colorizer-e4587/VB/Wpf_MapControl_ChoroplethColorizer/MainWindow.xaml#L13

<dxm:ChoroplethColorizer RangeStops="0 3000 10000 18000 28000 44000 82000 185000 1000000 2500000 15000000">
    <dxm:ChoroplethColorizer.ValueProvider>
        <dxm:ShapeAttributeValueProvider AttributeName="GDP_MD_EST"/>

mapcontrol-getting-started-lesson-2-load-a-vector-map-t190755/VB/MapControl_Lesson2/MainWindow.xaml#L20

<dxm:ChoroplethColorizer RangeStops="0 3000 10000 18000 28000 44000 82000 185000 1000000 2500000 15000000">
    <dxm:ChoroplethColorizer.ValueProvider>
        <dxm:ShapeAttributeValueProvider AttributeName="GDP_MD_EST"/>