Radial Gauge Control In UWP

The Radial Gauge Control displays a value in a certain range using a needle on a circular face. Radial Gauge control will make data visualizations and dashboards more engaging with rich style and interactivity. The round gauges are powerful, easy to use, and highly configurable to present dashboards capable of displaying clocks, industrial panels, automotive dashboards, and even aircraft cockpits.

Radial Gauge Control is from UWP Community Toolkit. The UWP Community Toolkit is a collection of helper functions, custom controls, and app services. It simplifies and demonstrates common developer tasks building UWP apps for Windows 10.

Reading this article, you can learn how to use Radial Gauge Control in Universal Windows Apps development with XAML and Visual C#.

The following important tools are required for developing UWP,

Step 1

Open Visual Studio 2017. Go to Start -> New Project-> select Windows Universal (under Visual C#)-> Blank App (Universal Windows) -> Give a suitable name for your app (UWPRadialGauge)->OK.

 

After choosing the target and minimum platform versions that your Windows Universal application will support (Windows Anniversary Update (10.0.14393.0)), the Project creates App.xaml and MainPage.xaml.

 

Step 2

First Update the Reference, Microsoft.NETCore.UniversalWindowsPlatform with the latest version of it using "Manage NuGet Packages".

Step 3

Add the following controls in design window for RadialGauge control view,

Add the TextBlock, Button Controls and change the Name and Text Property.

Add the RadialGauge control and set the Value, Minimum, Maximum, StepSize, IsInteractive, TickSpacing, ScaleWidth, MinAngle, MaxAngle, Unit, TickBrush, ScaleTickBrush, UnitBrush, ValueBrush, NeedleWidth, TickLength and Height Properties

  1. <Controls:RadialGauge x:Name="RGTest" Value="0" Minimum="0" Maximum="180" StepSize="1" IsInteractive="True" TickSpacing="20" ScaleWidth="5" MinAngle="212" MaxAngle="150" Unit="Units" TickBrush="Red" ScaleTickBrush="Black" UnitBrush="Black"alueBrush="Black" NeedleWidth="1" TickLength="9" Height="232" Margin="92,0,56,0" />  

 

 

Step 4

Add the following Source code to Mainpage.Xaml.cs for Speed Value increases by 10.

  1. private void BtnSpeed_Click(object sender, RoutedEventArgs e) {  
  2.     if (RGTest.IsInteractive == true && RGTest.Value < RGTest.Maximum) {  
  3.         RGTest.Value = RGTest.Value + 10;  
  4.     }  
  5. }  

Note

Automatically, the following code will be generated in XAML code view, while we are done in the design view.

  1. <Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:local="using:UWPRadialGauge" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" xmlns:Controls="using:Microsoft.Toolkit.Uwp.UI.Controls" x:Class="UWPRadialGauge.MainPage" mc:Ignorable="d">  
  2.     <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">  
  3.         <TextBlock x:Name="tblTitle" HorizontalAlignment="Left" Margin="211,133,0,0" TextWrapping="Wrap" Text="Radial Gauge Control in UWP" VerticalAlignment="Top" Width="287" Height="40" FontSize="20" FontWeight="Bold" />  
  4.         <StackPanel Margin="80,220,932,256">  
  5.             <Controls:RadialGauge x:Name="RGTest" Value="0" Minimum="0" Maximum="180" StepSize="1" IsInteractive="True" TickSpacing="20" ScaleWidth="5" MinAngle="212" MaxAngle="150" Unit="Units" TickBrush="Red" ScaleTickBrush="Black" UnitBrush="Black" ValueBrush="Black" NeedleWidth="1" TickLength="9" Height="232" Margin="92,0,56,0" /> </StackPanel>  
  6.         <Button x:Name="BtnSpeed" Content="Speed 10units" HorizontalAlignment="Left" Margin="606,198,0,0" VerticalAlignment="Top" Click="BtnSpeed_Click" /> </Grid>  
  7. </Page>  

Step 5

Deploy your app on the local machine. The output of the UWPRadialGauge is, 
After clicking the Speed10Units Button Control,
 
Summary

Now, you have successfully tested RadialGauge control in XAML and UWP environment using Visual Studio 2017.