ChartControl.AppearanceName Property

Gets or sets the name of the appearance which is currently being used to draw the chart elements.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v24.2.UI.dll

NuGet Package: DevExpress.Win.Charts

Declaration

C#

public string AppearanceName { get; set; }

VB.NET

Public Property AppearanceName As String

Property Value

Type	Description
String	A String value that is the appearance name.

Remarks

To get the full list of currently available appearances within the ChartControl, refer to the ChartControl.GetAppearanceNames method description.

Note

When the AppearanceName property is set to a non-default value (for instance to “Nature Colors”), the look and feel settings provided by the ChartControl.LookAndFeel property do not affect the chart control’s appearance.

Example

This example demonstrates how to customize a chart’s appearance at runtime, via the ChartControl.AppearanceName, ChartControl.PaletteName and ChartControl.PaletteBaseColorNumber properties.

Note that you can define a separate palette for painting all indicators available in your chart, via the ChartControl.IndicatorsPaletteName property.

Form1.cs

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
// ...
private void Form1_Load(object sender, EventArgs e) {
    // Create an empty chart.
    ChartControl barChart = new ChartControl();

    // Create a series and add points to it.
    Series series1 = new Series("Bar Series", ViewType.Bar);
    series1.Points.Add(new SeriesPoint("A", new double[] { 10 }));
    series1.Points.Add(new SeriesPoint("B", new double[] { 12 }));
    series1.Points.Add(new SeriesPoint("C", new double[] { 14 }));
    series1.Points.Add(new SeriesPoint("D", new double[] { 17 }));

    // Create an indicator (e.g. Regression Line),
    // and add it to the series' collection.
    RegressionLine myLine = new RegressionLine(ValueLevel.Value);
    ((SideBySideBarSeriesView)series1.View).Indicators.Add(myLine);

    // Add the series to the chart.
    barChart.Series.Add(series1);

    // Define the chart's appearance and palette.
    barChart.AppearanceName = "Dark";
    barChart.PaletteName = "Opulent";
    barChart.PaletteBaseColorNumber = 5;

    // Define a separate palette for the chart's indicators.
    barChart.IndicatorsPaletteName = "Default";

    // Add the chart to the form.
    barChart.Dock = DockStyle.Fill;
    this.Controls.Add(barChart);
}

Form1.vb

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
' ...
Private Sub Form1_Load(ByVal sender As Object, _ 
ByVal e As EventArgs) Handles MyBase.Load
    ' Create an empty chart.
    Dim barChart As New ChartControl()

    ' Create a series and add points to it.
    Dim series1 As New Series("Bar Series", ViewType.Bar)
    series1.Points.Add(New SeriesPoint("A", New Double() { 10 }))
    series1.Points.Add(New SeriesPoint("B", New Double() { 12 }))
    series1.Points.Add(New SeriesPoint("C", New Double() { 14 }))
    series1.Points.Add(New SeriesPoint("D", New Double() { 17 }))

    ' Create an indicator (e.g. Regression Line),
    ' and add it to the series' collection.
    Dim myLine As New RegressionLine(ValueLevel.Value)
    CType(series1.View, SideBySideBarSeriesView).Indicators.Add(myLine)

    ' Add the series to the chart.
    barChart.Series.Add(series1)

    ' Define the chart's appearance and palette.
    barChart.AppearanceName = "Dark"
    barChart.PaletteName = "Opulent"
    barChart.PaletteBaseColorNumber = 5

    ' Define a separate palette for the chart's indicators.
    barChart.IndicatorsPaletteName = "Default"

    ' Add the chart to the form.
    barChart.Dock = DockStyle.Fill
    Me.Controls.Add(barChart)
End Sub