The requested page is not available for the requested platform. You are viewing the content for Default platform.

Coloring

  • 5 min to read

The Web Dashboard control provides the capability to manage the coloring of dashboard item elements, such as chart series points or pie segments. To learn which dashboard items support coloring, see Coloring.

Color Schemes Overview

The dashboard provides two ways of coloring dashboard item elements.

  • Global color scheme. This color scheme provides consistent colors for identical values across the dashboard. The image below shows the dashboard containing Pie and Chart dashboard items. Pie segments and chart series points corresponding to Beverages, Condiments and Confections dimension values are colored using identical colors from the default palette.

    wdd-coloring-global-scheme

    Important

    When a global color scheme is used, the dashboard reserves automatically generated colors for certain values regardless of the filter state.

  • Local color scheme. This color scheme provides an independent set of colors for each dashboard item.

    Important

    When a local color scheme is used, the dashboard reassigns palette colors when the filter state is changed.

To select a type of coloring dashboard item elements, open the dashboard item menu, go to the Color Scheme section and use the Color Scheme Type option.

wdd-coloring-change-color-scheme

Color Measures and Dimensions

Dashboard items allow you to manage the coloring of individual dimensions or all dashboard item measures using predefined coloring modes.

The following coloring settings are available.

Coloring Mode Description
Auto Dimension values/measures are colored by default. To learn how specific dashboard items color their elements by default, see the Coloring topic for the corresponding dashboard item.
On Dimension values/measures are colored by different hues.
Off Dimension values/measures are colored with the same color.

You can configure coloring in two ways.

  • To specify the coloring mode for the specific measure/dimension, open the data item menu and go to Data Shaping section. Use the Coloring option to specify coloring mode of this data item.

    wdd-coloring-data-item-options

  • To see a list of all measures/dimensions for which you can specify coloring mode, open the dashboard item's Options menu and go to the Coloring section.

    wdd-coloring-options

For example, the image below shows the Chart dashboard item whose Country dimension is colored by different hues...

wdd-coloring-color-by-measure

...and this image shows the Pie dashboard item whose measures are colored by different hues.

wdd-coloring-by-measure

Note

If you enable coloring by different hues for several dimensions/measures, all combinations of dimension values/measures are colored with different colors from the default palette.

Customize Color Palettes in the Dashboard Item Menu

The Web Dashboard control allows you to customize colors of the specific palette using the Color Scheme section of the dashboard item Options menu. To edit the color scheme, click the Edit button (the wdd-icon-edit-collection-value-item icon) of the corresponding color.

wdd-coloring-change-dashboard-item-color-scheme

Then, pick any color using the RGB color model in the invoked color picker and click Confirm to change the color.

wdd-coloring-color-picker

A new color scheme will be applied to the dashboard item(s).

wdd-coloring-change-local-scheme

Note

By default, the dashboard colors dimension values/measures using the default palette that contains 20 unique colors. If necessary, you can substitute the default palette by handling one of the following events.

Customize Color Palettes in the Color Schemes Page

The Color Scheme page of the dashboard menu allows you to customize color tables by editing and adding colors.

wdd-coloring-scheme-page

  • Edit colors. You can reassign a color in the selected color table. For this, select one of the available schemes in the Color Schemes pane and click the required color in the Colors pane to provide access to the Color combo box.

    Clicking the Color dropdown button invokes a color picker where you can specify a new color.

    wdd-coloring-invoke-color-picker

    Click Confirm to change the automatically assigned color for the selected value and update the current color scheme.

    wdd-coloring-changed-color

    The image below demonstrates the dashboard items that are colored using the updated color table.

    wdd-coloring-new-scheme

  • Add colors. The Color Scheme page allows you to add a new value with the specified color to the selected color scheme. To do this, use the Add color button.

    wdd-coloring-adding-color

    Specify the dimension value of the added color or select the required measures. This creates a new value whose color can be specified as described in the Edit colors section.

    wdd-coloring-added-color

    Click Remove (the wdd-icon-delete-big icon) to remove colors.

Customize Color Palettes in Code

DevExpress Dashboard uses a set of 20 unique colors from the default palette to color dashboard item elements (for instance, Chart series points or Pie segments). You can use the static DashboardPalette.Default field to access the default palette.

Handle the ASPxDashboard.CustomPalette / DashboardConfigurator.CustomPalette event to create your own palette providing custom colors. To do this, create and initialize the DashboardPalette class instance and assign the resulting object to the CustomPaletteWebEventArgs.Palette event parameter:

using DevExpress.DashboardCommon;
using DevExpress.DashboardWeb;
using System.Collections.Generic;
using System.Drawing;

// ...

protected void ASPxDashboard1_CustomPalette(object sender, CustomPaletteWebEventArgs e) {
    List<Color> customColors = new List<Color>();
    customColors.Add(Color.LightBlue);
    customColors.Add(Color.Aquamarine);
    customColors.Add(Color.SkyBlue);
    customColors.Add(Color.LightCoral);
    customColors.Add(Color.Tomato);
    customColors.Add(Color.IndianRed);            
    customColors.Add(Color.Violet);
    customColors.Add(Color.Plum);
    customColors.Add(Color.MediumOrchid);

    e.Palette = new DashboardPalette(customColors);
}