Skip to main content
A newer version of this page is available. .

Color Schemes

  • 4 minutes to read

Color scheme is a feature that provides the quick and handy way to set a unified appearance for all range bars, state image indicators, images and labels within a GaugeControl. Although all these elements are common elements for any analog (circular or linear) gauge, applying color schemes to gauges with Ignis and Haze styles is the best idea. Gauges of these styles have no elements that cannot be colorized (needles, spindle caps, tickmarks etc) so the a color scheme will have the most impact on these. The figure below illustrates an example of four GaugeControl with different color schemes applied.

XtraGauges - Image Indicator (static)


For best visual results use monochrome images on a transparent background for all image elements that will be colorized via a color scheme.

To set a color scheme you need to specify only two settings, accessed via the GaugeControlBase.ColorScheme property:

  • ColorScheme.TargetElements - allows you to specify which gauge elements will be affected by this color scheme. It does not matter whether or not you currently have this or that element within your gauge (a range bar, for instance) - the TargetElements property enumerates gauge element types, not specific elements.
  • ColorScheme.Color - gets or sets the color that will be used to paint selected TargetElements.

When both properties are set, your color scheme is ready to go. You can turn it off for individual elements by doing one of the following:

  • painting the desired element with a SolidBrushObject or BaseGradientBrushObject object. Color scheme is only applied to elements painted with an empty brush object. Use this method to set a custom color for the element.

    arcScaleRangeBarComponent2.Appearance.ContentBrush = new SolidBrushObject(Color.Gray);
  • Set the element’s UseColorScheme property to false. This approach is used to leave default skin colors for the target element.

    labelComponent2.UseColorScheme = false;

You can modify color scheme colors depending on an external factor. For instance, the following animation illustrates one of the DevExpress gauge demos, where the state image indicator, the range bar and one of the labels are painted in different colors depending on the current temperature.

XtraGauges - State Image Indicators and Color Scheme


The following example lists a code that applies the same color scheme to the set of gauge controls as the figure below illustrates.

XtraGauges - Movie Gauges (light)

Each gauge control has a single gauge with the Ignis style applied. The default arc scale and range bar are duplicated via the Gauge Designer and arranged inside the outer scale. The outer scale ranges from 0 to 100 and displays the movie metascore. This value affects the color of the color scheme applied to the following elements: the outer range bar, the star image and two labels for IMDb and Metacritics movie scores. The inner range bar that displays the movie budget, as well the label related to this range bar, ignore the color scheme settings and are customarily painted in gray.

private void simpleButton1_Click(object sender, EventArgs e) {
    foreach (var gauge in this.Controls.OfType<GaugeControl>())
        SetColorScheme(gauge, (gauge.Gauges[0] as CircularGauge).Scales[0]);

public void SetColorScheme(GaugeControl gauge, IScale metaRankScale) {
    CircularGauge movieGauge = gauge.Gauges[0] as CircularGauge;
    float metascore = metaRankScale.Value;
    //Setting appearance for elements unaffected by the color scheme
    movieGauge.RangeBars[1].AppearanceRangeBar.ContentBrush = movieGauge.Labels[2].AppearanceText.TextBrush = new SolidBrushObject(Color.Gray);
    //Setting color scheme parameters for the rest of gauge elements
    if (metascore < 50F) gauge.ColorScheme.Color = Color.Crimson;
    else if (metascore >= 50F & metascore < 70F) gauge.ColorScheme.Color = Color.Chocolate;
    else if (metascore >= 70F) gauge.ColorScheme.Color = Color.SeaGreen;