[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
   [Expand]Getting Started
    [Expand]Gauge Types
    [Collapse]Visual Elements
     [Collapse]Analog Gauges
       Value Indicators
       Labels and Images
       State and State Image Indicators
       Ornamental Elements
     [Expand]Digital Gauges
     [Expand]State Indicator Gauges
    [Expand]Appearance Customization
     Coordinate System
     Data Binding
     Saving and Restoring Gauge Layout and Style Settings
   [Expand]Design-Time Features
   [Expand]Product Information
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[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]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)

Labels and Images

Labels and images serve to display custom text or graphic content within gauges. As other gauge elements, these can be added at design-time using gauge smart-tag or Gauge Designer.

Expanded Custom Labels

All types of gauges support custom labels. Custom labels provide the following features.

  • They can be displayed above or below any other gauge element.

    To specify the label's position along the Z-axis, use the label's ZOrder property.

  • Support for HTML formatting of the label's text.

    You can use specific HTML tags to format the label's text. See Label.Text to learn more.

At design time, you can add a custom label by using the gauge's smart tag menu.

Then, you can edit the label in one of the following two ways:

  • select the Label on the gauge and you will get access to its properties in the Property Grid;

  • locate the label's smart tag on the windows form and click Run Designer.

Then, in the invoked designer, you can customize label appearance, geometry and text.

Custom labels are represented by LabelComponent class objects.

When you add a custom label at design time, it's added to the gauge's BaseGaugeWin.Labels collection.

Expanded Images

Images are static elements used to decorate your gauges. These elements, as well as custom labels, can reflect the value that this gauge measures (see the figure below).

There are two ways to add an ImageIndicatorComponent object that represents a custom image (these ways are common to all gauge elements).

  1. By clicking the related link within the gauge's smart-tag.

  2. By clicking the icon or cloning existing images in Gauge Designer.

To assign an image to the ImageIndicatorComponent object, use its Image property. The image can be colorized if a Color Scheme is used.


For best visual results, apply the Color Schemes only to monochrome images on a transparent background.

If you need a single gauge to display multiple images that will replace each other, depending on the specific gauge value or an external cause, use State Image Indicators instead.

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