Skip to main content

Lesson 3 - Create a Digital Gauge

  • 4 minutes to read

This is the third tutorial of the DXGauges Getting Started series. It will guide you through the process of creating a Digital gauge and adjusting its common settings.

This tutorial consists of the following steps.

  1. Create a New Project and Add a Gauge Control
  2. Select a Symbol View Type
  3. Specify a Text
  4. Add a Layer and Customize the Gauge Layout
  5. Specify a Model
  6. Customize Animation Settings
  7. Result

Step 1. Create a New Project and Add a Gauge Control

In this step, we will perform the common actions that are required when you add a Gauge control to your application.

  • Run Microsoft Visual Studio.
  • Create a new WPF Application project.
  • Add the DigitalGaugeControl component to your project. To do this, locate the DigitalGaugeControl item in a Visual Studio toolbox on the DX.22.2: Data & Analytics tab and drop it onto the main window.

    Lesson3_01_Selection a Digital Gauge

  • Right-click the DigitalGaugeControl object and choose the Reset Layout | All option in the context menu. This will stretch the Gauge control to fill the whole window.


  • After this, your XAML may look like the following. If it doesn’t, you can overwrite your code with:

    <Window x:Class="Digital_Gauge.MainWindow"
            Title="MainWindow" Height="350" Width="525">
            <dxga:DigitalGaugeControl Name="digitalGaugeControl1"/>           

Step 2. Select a Symbol View Type

The Digital Gauge control can represent its content using one of the predefined symbol view types: 7 segments, 14 segments, 5x8 and 8x14 segment matrices.

In this example, we will use the 8x14 segment matrix to display a creeping line with a custom text.

Step 3. Specify a Text

A 8x14 segment matrix can display any text consisting of numbers, Latin or other characters.

  • Let’s add custom text to the digital gauge. For this, set the DigitalGaugeControl.Text property to ON AIR.


    The digital gauge displays this text immediately at design time within Visual Studio.


Step 4. Add a Layer and Customize the Gauge Layout

In this step, we’ll add a layer to the Digital Gauge control and align the gauge vertically.

  • To add a layer to the digital gauge, locate the DigitalGaugeControl.Layers property on the Properties window. Then, click the ellipsis button to invoke the Layers collection editor. In this editor, add a new DigitalGaugeLayer object using the Add button.

    DigitalGauge_Lesson3_Add a Layer

  • Let’s change the digital gauge layout. For this, set the VerticalAlignment property to Center.

    After this, the MainWindow should look like the following.


Step 5. Specify a Model

In this step, we’ll select a model for the Digital Gauge control.

  • For this, locate the DigitalGaugeControl.Model property and select DigitalClassicModel from the drop-down list.


    Now the Gauge control should look as shown in the image below.


Step 6. Customize Animation Settings

The digital gauge supports two animation types: creeping line and blinking animation. In this lesson, we’ll use the creeping lime animation to demonstrate a moving text.

Step 7. Result

After performing all the steps, your XAML should look as follows.

<Window x:Class="Digital_Gauge.MainWindow"
        Title="MainWindow" Height="350" Width="525">
        <dxga:DigitalGaugeControl Name="digitalGaugeControl1" Text="ON AIR" 
                <dxga:DigitalClassicModel />
                <dxga:DigitalGaugeLayer />
                        <dxga:CreepingLineAnimation Repeat="True" 
                                                    RefreshTime="00:00:01" />
  • Run the project to see the result.



A complete sample project is available in the DevExpress Code Examples database at

See Also