[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Collapse]Gauge Controls
   [Expand]Getting Started
    Value Indicators
   [Collapse]Visual Elements
    [Collapse]Circular Gauge
      Arc Scale
      Range Bar
      Custom Labels
      Spindle Cap
      Custom Elements
    [Expand]Linear Gauge
    [Expand]Digital Gauge
    [Expand]State Indicator
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


Layer is an element that contains different objects (e.g. images) to define a visual presentation of a gauge and its elements.

Layers can be added at two levels:

For example, the following picture illustrates three layers - one is added to the CircularGaugeControl and therefore occupies the whole Gauge control's space; and two other layers are added to ArcScale objects.


The above illustration shows three layers with each having different presentation settings. However, you can choose the same appearance for all layers in your Gauge control, so that they better correspond to each other.

Every new layer is painted behind all other gauge elements, because its LayerOptions.ZIndex property is set to -100 by default. If you want to bring this layer in front of other gauge elements (or paint it above other layers, if there are any), you need to set the ZIndex property to a greater value.

For example, the following picture illustrates two layers added to the same ArcScale object - one layer defines its background and a dark circle, while another layer is placed in a foreground to add a "glassy" effect to the scale.

The table below lists the main properties affecting element behavior and appearance.

Characteristics Members
Availability CircularGaugeControl.Layers, ArcScale.Layers
Visibility LayerBase.Visible
Appearance CircularGaugeControl.Model,CircularGaugeLayer.Presentation,ArcScaleLayer.Presentation
Behaviour GaugeLayerBase.Options

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