[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
   Getting Started
  [Expand]Grid View
  [Expand]Tree List
  [Expand]Card View
  [Expand]Chart Control
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Site Navigation and Layout
  [Expand]HTML Editor
   [Expand]Product Information
   [Expand]Getting Started
    [Expand]Gauge Types
    [Expand]Gauge Elements
      Gauge Styles
      Appearance Customization
      Custom Draw
     Data Binding
     Layout Customization
   [Expand]Visual Elements
   [Expand]Design-time Features
  [Expand]Vertical Grid
  [Expand]Data Editors
  [Expand]Docking and Popups
  [Expand]File Management
  [Expand]Data and Image Navigation
  [Expand]Multi-Use Site Controls
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Appearance Customization

The ASPxGaugeControl contains numerous settings that allow you to build an appearance for both gauges and their elements according to your needs.

This document lists the available tools required for customizing a gauge appearance, and describes how they can be accessed at design time.

Expanded Brushes

Brushes are used to paint an element's background, borders, content and text.

You can use brushes to alter the appearance of the following gauge elements.

  • In circular and linear gauges: scales and their major and minor tickmarks, labels, range bars.
  • In digital gauges: segments, labels.
  • In state indicators: labels.

For your convenience, the properties that represent brushes starting with the Appearance... prefix.

You can access brushes using the gauge element's Designer.

To accomplish it, do the following.

  • Locate the Gauge control's smart tag and click Customize Gauge Control....

  • Then, in the Visual Gauge Control Designer, locate the scale's smart tag and click Run Designer.

In Scales - Element Designer you can see Appearance... properties for an ArcScaleComponent object that represents a scale in circular gauges.

Let's alter the scale appearance. To do this, change the ArcScaleComponent.AppearanceScale and ArcScaleComponent.AppearanceTickmarkText properties as shown below.

The circular gauge should look like the following.

Expanded Shaders

The appearance of most gauge elements is specified by the current gauge style (predefined image) applied to this element.

In addition, you can use the shader mechanism that allows you to change the color theme by mixing default colors with custom colors.

A shader is an object that implements the color blending feature. You can specify a shader for a gauge element via the element's BaseLeafPrimitive.Shader property.

The image below shows the list of shaders for the ArcScaleBackgroundLayerComponent object.

A StyleShader is the most used shader. It allows you to specify two colors for the resultant color calculation.

The StyleShader works the following way.

First, it calculates a grey tone (a value between 0 and 255) corresponding to the input color of the predefined image. The shader's two colors define the range of colors in the color space. The output color is calculated as a projection of the grey tone onto this range.

The following image shows the result of blending colors for a sample background layer.

To learn more about background layer, see the corresponding section of the Circular Gauge (Visual Elements) topic.

Is this topic helpful?​​​​​​​