ChoroplethColorizer.RangeDistribution Property

Gets or sets the distribution type of range colors in a colorizer.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v19.1.dll

Declaration

C#

public IRangeDistribution RangeDistribution { get; set; }

VB.NET

Public Property RangeDistribution As IRangeDistribution

Property Value

Type	Description
DevExpress.Map.IRangeDistribution	An object implementing the DevExpress.Map.IRangeDistribution interface.

Example

Set the LinearRangeDistribution, LogarithmicRangeDistribution or ExponentialRangeDistribution object to the ChoroplethColorizer.RangeDistribution property. Note that if the ChoroplethColorizer.ApproximateColors property value equals false, shapes with values inside one range interval have the same color.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-configure-a-range-distribution-of-choroplethcolorizer-t142434

Form1.cs

using System;
using System.Collections.Generic;
using System.Windows.Forms;
using DevExpress.Map;
using DevExpress.XtraMap;

namespace RangeDistributions {
    public partial class Form1 : Form {
        const string filepath = "../../Data/Countries.shp";

        List<RangeDistributionBase> distributions = new List<RangeDistributionBase>{ 
            new LinearRangeDistribution(),
            new LogarithmicRangeDistribution(),
            new ExponentialRangeDistribution()
        };

        VectorItemsLayer MapLayer { get { return (VectorItemsLayer)mapControl1.Layers["MapLayer"]; } }
        ChoroplethColorizer Colorizer { get { return (ChoroplethColorizer)MapLayer.Colorizer; } }
        ShapefileDataAdapter Adapter { get { return (ShapefileDataAdapter)MapLayer.Data; } }

        public Form1() {
            InitializeComponent();

            cbRangeDistribution.DataSource = distributions;

            Uri baseUri = new Uri(System.Reflection.Assembly.GetEntryAssembly().Location);
            Adapter.FileUri = new Uri(baseUri, filepath);
        }

        private void cbRangeDistribution_SelectedIndexChanged(object sender, EventArgs e) {
            RangeDistributionBase selectedDistribution = cbRangeDistribution.SelectedItem as RangeDistributionBase;
            if (selectedDistribution == null) return;

            if (selectedDistribution.Equals(distributions[0])) seFactor.Enabled = false;
            else {
                seFactor.Enabled = true;
                EquationRangeDistribution eqDistribution = selectedDistribution as EquationRangeDistribution;
                eqDistribution.Factor = (double)seFactor.Value;
            }

            Colorizer.RangeDistribution = selectedDistribution;
        }

        private void seFactor_EditValueChanged(object sender, EventArgs e) {
            EquationRangeDistribution distribution = Colorizer.RangeDistribution as EquationRangeDistribution;
            if (distribution == null) return;

            distribution.Factor = (double)seFactor.Value;
        }

        #region #ApproximateColors
        private void cbApproximateColors_CheckedChanged(object sender, EventArgs e) {
            Colorizer.ApproximateColors = cbApproximateColors.Checked;
        }
        #endregion #ApproximateColors
    }
}

Form1.vb

Imports System
Imports System.Collections.Generic
Imports System.Windows.Forms
Imports DevExpress.Map
Imports DevExpress.XtraMap

Namespace RangeDistributions
    Partial Public Class Form1
        Inherits Form

        Private Const filepath As String = "../../Data/Countries.shp"

        Private distributions As New List(Of RangeDistributionBase)() From { _
            New LinearRangeDistribution(), _
            New LogarithmicRangeDistribution(), _
            New ExponentialRangeDistribution() _
        }

        Private ReadOnly Property MapLayer() As VectorItemsLayer
            Get
                Return CType(mapControl1.Layers("MapLayer"), VectorItemsLayer)
            End Get
        End Property
        Private ReadOnly Property Colorizer() As ChoroplethColorizer
            Get
                Return CType(MapLayer.Colorizer, ChoroplethColorizer)
            End Get
        End Property
        Private ReadOnly Property Adapter() As ShapefileDataAdapter
            Get
                Return CType(MapLayer.Data, ShapefileDataAdapter)
            End Get
        End Property

        Public Sub New()
            InitializeComponent()

            cbRangeDistribution.DataSource = distributions

            Dim baseUri As New Uri(System.Reflection.Assembly.GetEntryAssembly().Location)
            Adapter.FileUri = New Uri(baseUri, filepath)
        End Sub

        Private Sub cbRangeDistribution_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) Handles cbRangeDistribution.SelectedIndexChanged
            Dim selectedDistribution As RangeDistributionBase = TryCast(cbRangeDistribution.SelectedItem, RangeDistributionBase)
            If selectedDistribution Is Nothing Then
                Return
            End If

            If selectedDistribution.Equals(distributions(0)) Then
                seFactor.Enabled = False
            Else
                seFactor.Enabled = True
                Dim eqDistribution As EquationRangeDistribution = TryCast(selectedDistribution, EquationRangeDistribution)
                eqDistribution.Factor = CDbl(seFactor.Value)
            End If

            Colorizer.RangeDistribution = selectedDistribution
        End Sub

        Private Sub seFactor_EditValueChanged(ByVal sender As Object, ByVal e As EventArgs) Handles seFactor.EditValueChanged
            Dim distribution As EquationRangeDistribution = TryCast(Colorizer.RangeDistribution, EquationRangeDistribution)
            If distribution Is Nothing Then
                Return
            End If

            distribution.Factor = CDbl(seFactor.Value)
        End Sub

        #Region "#ApproximateColors"
        Private Sub cbApproximateColors_CheckedChanged(ByVal sender As Object, ByVal e As EventArgs) Handles cbApproximateColors.CheckedChanged
            Colorizer.ApproximateColors = cbApproximateColors.Checked
        End Sub
        #End Region ' #ApproximateColors
    End Class
End Namespace

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the RangeDistribution 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-configure-a-range-distribution-of-choroplethcolorizer-t142434/CS/RangeDistributions/Form1.cs#L41

    Colorizer.RangeDistribution = selectedDistribution;
}

VB.NET

how-to-configure-a-range-distribution-of-choroplethcolorizer-t142434/VB/RangeDistributions/Form1.vb#L58

    Colorizer.RangeDistribution = selectedDistribution
End Sub