Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
  [Expand]Reporting
  [Expand]Chart Control
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Expand]Scheduler
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Collapse]Gauges
   [Expand]Product Information
   [Expand]Getting Started
   [Expand]Fundamentals
   [Collapse]Concepts
    [Expand]Gauge Types
    [Expand]Gauge Elements
    [Collapse]Appearance
      Gauge Styles
      Appearance Customization
      Custom Draw
     Data Binding
     Layout Customization
   [Expand]Visual Elements
   [Expand]Design-time Features
   [Expand]Examples
  [Expand]Data Editors
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[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.

How would you rate this topic?​​​​​​​