ColorObjectColorizer Class

A colorizer that allows providing Color objects stored in SeriesBase.ColorDataMember to series points.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.1.dll

Declaration

C#

[TypeConverter(typeof(ColorObjectColorizerTypeConverter))]
public class ColorObjectColorizer :
    ChartColorizerBase

VB.NET

<TypeConverter(GetType(ColorObjectColorizerTypeConverter))>
Public Class ColorObjectColorizer
    Inherits ChartColorizerBase

Remarks

For more information about colorizers, refer to the Series Point Colorizer topic.

Example

To use the Color Object Colorizer, do the following.

Create a ColorObjectColorizer object and assign it to the SeriesBase.Colorizer property. Additional configuration is not required.

Note

This colorizer is used by default.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-colorize-charts-using-the-color-object-colorizer-t245209

Form1.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
using System.Xml.Linq;
using DevExpress.XtraCharts;

namespace ColorObjectColorizerExample {
    public partial class Form1 : Form {
        const string filepath = "..\\..\\Data\\GDP.xml";

        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            #region #BarSeries
            // Create and customize a bar series.
            Series barSeries = new Series() {
                DataSource = LoadData(filepath),
                Colorizer = new ColorObjectColorizer(),
                ArgumentDataMember = "Country",
                ColorDataMember = "NationalColor",
                View = new SideBySideBarSeriesView()
            };
            barSeries.ValueDataMembers.AddRange(new string[] { "Product" });
            #endregion #BarSeries

            // Add the series to the ChartControl's Series collection.
            chartControl1.Series.Add(barSeries);

            // Show a title for the values axis.
            ((XYDiagram)chartControl1.Diagram).AxisY.Title.Text = "GDP per capita, $";
            ((XYDiagram)chartControl1.Diagram).AxisY.Title.Visibility = DevExpress.Utils.DefaultBoolean.True;
        }

        #region #DataLoad
        class HpiPoint {
            public string Country { get; set; }
            public double Product { get; set; }
            public string NationalColor { get; set; }
        }

        // Loads data from an XML data source.
        static List<HpiPoint> LoadData(string filepath) {
            XDocument doc = XDocument.Load(filepath);
            List<HpiPoint> points = new List<HpiPoint>();
            foreach (XElement element in doc.Element("G20HPIs").Elements("CountryStatistics")) {
                points.Add(new HpiPoint() {
                    Country = element.Element("Country").Value,
                    Product = Convert.ToDouble(element.Element("Product").Value),
                    NationalColor = element.Element("NationalColor").Value
                });
            }
            return points;
        }
        #endregion #DataLoad
    }
}

Form1.vb

Imports System
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Linq
Imports System.Text
Imports System.Threading.Tasks
Imports System.Windows.Forms
Imports System.Xml.Linq
Imports DevExpress.XtraCharts

Namespace ColorObjectColorizerExample
    Partial Public Class Form1
        Inherits Form

        Private Const filepath As String = "..\..\Data\GDP.xml"

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
'            #Region "#BarSeries"
            ' Create and customize a bar series.
            Dim barSeries As New Series() With {.DataSource = LoadData(filepath), .Colorizer = New ColorObjectColorizer(), .ArgumentDataMember = "Country", .ColorDataMember = "NationalColor", .View = New SideBySideBarSeriesView()}
            barSeries.ValueDataMembers.AddRange(New String() { "Product" })
'            #End Region ' #BarSeries

            ' Add the series to the ChartControl's Series collection.
            chartControl1.Series.Add(barSeries)

            ' Show a title for the values axis.
            CType(chartControl1.Diagram, XYDiagram).AxisY.Title.Text = "GDP per capita, $"
            CType(chartControl1.Diagram, XYDiagram).AxisY.Title.Visibility = DevExpress.Utils.DefaultBoolean.True
        End Sub

        #Region "#DataLoad"
        Private Class HpiPoint
            Public Property Country() As String
            Public Property Product() As Double
            Public Property NationalColor() As String
        End Class

        ' Loads data from an XML data source.
        Private Shared Function LoadData(ByVal filepath As String) As List(Of HpiPoint)
            Dim doc As XDocument = XDocument.Load(filepath)
            Dim points As New List(Of HpiPoint)()
            For Each element As XElement In doc.Element("G20HPIs").Elements("CountryStatistics")
                points.Add(New HpiPoint() With {.Country = element.Element("Country").Value, .Product = Convert.ToDouble(element.Element("Product").Value), .NationalColor = element.Element("NationalColor").Value})
            Next element
            Return points
        End Function
        #End Region ' #DataLoad
    End Class
End Namespace

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ColorObjectColorizer class.

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-colorize-charts-using-the-color-object-colorizer-t245209/CS/ColorObjectColorizerExample/Form1.cs#L26

DataSource = LoadData(filepath),
Colorizer = new ColorObjectColorizer(),
ArgumentDataMember = "Country",

VB.NET

how-to-colorize-charts-using-the-color-object-colorizer-t245209/VB/ColorObjectColorizerExample/Form1.vb#L26

' Create and customize a bar series.
Dim barSeries As New Series() With {.DataSource = LoadData(filepath), .Colorizer = New ColorObjectColorizer(), .ArgumentDataMember = "Country", .ColorDataMember = "NationalColor", .View = New SideBySideBarSeriesView()}
barSeries.ValueDataMembers.AddRange(New String() { "Product" })

Implements

IColorizer

Inheritance

Object

ChartElement

ChartColorizerBase

ColorObjectColorizer