Migrate from Xamarin.Forms SfDigitalGauge to .NET MAUI SfDigitalGauge

7 Jan 202512 minutes to read

To make the migration from the Xamarin SfDigitalGauge to the .NET MAUI SfDigitalGauge easier, most of the similar APIs from the Xamarin SfDigitalGauge were kept in the .NET MAUI SfDigitalGauge. Also, the APIs has been restructured by considering various use cases and maintaining API consistency. Please find the difference in the following topics.

Initialize control

To initialize the control, import the gauge namespace and initialize SfDigitalGauge as shown in the following code sample.

Xamarin SfDigitalGauge .NET MAUI SfDigitalGauge 
<ContentPage
    xmlns:gauge="clr-namespace:Syncfusion.SfGauge.XForms;assembly=Syncfusion.SfGauge.XForms">

        <gauge:SfDigitalGauge/>

</ContentPage>
using Syncfusion.SfGauge.XForms;
...

SfDigitalGauge digitalGauge = new SfDigitalGauge();
this.Content = digitalGauge;
 
<ContentPage
    xmlns:gauge="clr-namespace:Syncfusion.Maui.Gauges;assembly=Syncfusion.Maui.Gauges">

        <gauge:SfDigitalGauge/>

</ContentPage>
using Syncfusion.Maui.Gauges;
...

SfDigitalGauge digitalGauge = new SfDigitalGauge();
this.Content = digitalGauge;

Properties

The following code example, explains how to initialize the properties of the Xamarin SfDigitalGauge and .NET MAUI SfDigitalGauge.

Xamarin SfDigitalGauge .NET MAUI SfDigitalGauge Description

Value

Text

 Gets or sets the value of the text of the digital gauge.

SegmentStrokeWidth

StrokeWidth

 Gets or sets the value stroke width of the segment.

DisabledSegmentColor

DisabledSegmentStroke

 Gets or sets a color for the disabled segment of the digital gauge

CharacterStrokeColor

CharacterStroke

 Gets or sets a color for the text color of the digital gauge

CharacterWidth

CharacterWidth

 Gets or sets a value to the character width.

DisabledSegmentAlpha

DisabledSegmentAlpha

 Gets or sets a value to visibility of the disabled segment.

CharacterHeight

CharacterHeight

 Gets or sets the value for the character height

CharacterSpacing

CharacterSpacing

 Gets or sets the value for the character spacing

The following code example explains how to initialize the segments in Xamarin SfDigitalGauge and .NET MAUI SfDigitalGauge.

Xamarin SfDigitalGauge .NET MAUI SfDigitalGauge 
<gauge:SfDigitalGauge Value="SYNCFUSION" SegmentStrokeWidth="4" 
                          HeightRequest="100"  WidthRequest="340"
                          DisabledSegmentAlpha="25" DisabledSegmentColor="Gray"
                          CharacterHeight="90" CharacterWidth="25" 
                          HorizontalOptions="Center" VerticalOptions="Center"
                          CharacterType="SegmentSeven" 
                         CharacterStrokeColor="#146CED"/>
SfDigitalGauge digital = new SfDigitalGauge();

            digital.HeightRequest = 100;

            digital.WidthRequest = 340;

            digital.Value = "SYNCFUSION";

            digital.CharacterHeight = 90;

            digital.CharacterWidth = 25;

            digital.HorizontalOptions = LayoutOptions.Center;

            digital.VerticalOptions = LayoutOptions.Center;

            digital.SegmentStrokeWidth = 4;

            digital.CharacterType = CharacterType.SegmentSeven;

            digital.DisabledSegmentAlpha = 25;

            digital.CharacterStrokeColor = Color.FromRgb(20, 108, 237);

            digital.DisabledSegmentColor = Color.Gray;
 
<gauge:SfDigitalGauge Text="1 2 3 4 5" StrokeWidth="5" 
                          HeightRequest="100"  WidthRequest="300"
                          DisabledSegmentAlpha="25" DisabledSegmentStroke="LightSkyBlue"
                          CharacterHeight="90" CharacterWidth="25" 
                          HorizontalOptions="Center" VerticalOptions="Center"
                          CharacterType="SevenSegment" 
                         CharacterStroke="#146CED"/>
SfDigitalGauge digital = new SfDigitalGauge();

            digital.HeightRequest = 100;

            digital.WidthRequest = 300;

            this.BackgroundColor = Color.White;

            digital.Text = "1 2 3 4 5";

            digital.CharacterHeight = 90;

            digital.CharacterWidth = 25;

            digital.HorizontalOptions = LayoutOptions.Center;

            digital.VerticalOptions = LayoutOptions.Center;

            digital.StrokeWidth = 5;

            digital.CharacterType = CharacterType.SevenSegment;

            digital.DisabledSegmentAlpha = 25;

            digital.CharacterStroke = Color.FromRgb(20, 108, 237);

            digital.DisabledSegmentStroke = Color.LightSkyBlue;

Enum

Xamarin SfDigitalGauge .NET MAUI SfDigitalGauge Description

CharacterType

DigitalGaugeCharacterType

 Defines the character segment type for the SfDigitalGauge.

Character Types

</tr> </table> The following code example explains how to initialize the character type in Xamarin SfDigitalGauge and .NET MAUI SfDigitalGauge.
Xamarin SfDigitalGauge .NET MAUI SfDigitalGauge Description

SegmentSeven

SevenSegment

 The seven-segment type is capable of displaying numbers and a few uppercase letters efficiently.

SegmentFourteen

FourteenSegment

 The fourteen-segment type is capable of displaying numbers and alphabet efficiently.

SegmentSixteen

SixteenSegment

 The sixteen-segment type is capable of displaying numbers and alphabet clearly.

EightCrossEightDotMatrix

/td>

EightCrossEightDotMatrix

 The dot matrix segment type is capable of displaying numbers, alphabet, and special characters efficiently.
Xamarin SfDigitalGauge .NET MAUI SfDigitalGauge 
<gauge:SfDigitalGauge Value="SYNCFUSION" SegmentStrokeWidth="4" 
                          HeightRequest="100"  WidthRequest="340"
                          DisabledSegmentAlpha="25" DisabledSegmentColor="Gray"
                          CharacterHeight="90" CharacterWidth="25" 
                          HorizontalOptions="Center" VerticalOptions="Center"
                          CharacterType="SegmentSeven" 
                         CharacterStrokeColor="#146CED"/>
SfDigitalGauge digital = new SfDigitalGauge();

            digital.HeightRequest = 100;

            digital.WidthRequest = 340;

            digital.Value = "SYNCFUSION";

            digital.CharacterHeight = 90;

            digital.CharacterWidth = 25;

            digital.HorizontalOptions = LayoutOptions.Center;

            digital.VerticalOptions = LayoutOptions.Center;

            digital.SegmentStrokeWidth = 4;

            digital.CharacterType = CharacterType.SegmentSeven;

            digital.DisabledSegmentAlpha = 25;

            digital.CharacterStrokeColor = Color.FromRgb(20, 108, 237);

            digital.DisabledSegmentColor = Color.Gray;
 
<gauge:SfDigitalGauge Text="1 2 3 4 5" StrokeWidth="5" 
                          HeightRequest="100"  WidthRequest="300"
                          DisabledSegmentAlpha="25" DisabledSegmentStroke="LightSkyBlue"
                          CharacterHeight="90" CharacterWidth="25" 
                          HorizontalOptions="Center" VerticalOptions="Center"
                          CharacterType="SevenSegment" 
                         CharacterStroke="#146CED"/>
SfDigitalGauge digital = new SfDigitalGauge();

            digital.HeightRequest = 100;

            digital.WidthRequest = 300;

            this.BackgroundColor = Color.White;

            digital.Text = "1 2 3 4 5";

            digital.CharacterHeight = 90;

            digital.CharacterWidth = 25;

            digital.HorizontalOptions = LayoutOptions.Center;

            digital.VerticalOptions = LayoutOptions.Center;

            digital.StrokeWidth = 5;

            digital.CharacterType = CharacterType.SevenSegment;

            digital.DisabledSegmentAlpha = 25;

            digital.CharacterStroke = Color.FromRgb(20, 108, 237);

            digital.DisabledSegmentStroke = Color.LightSkyBlue;
## Event
Xamarin SfDigitalGauge .NET MAUI SfDigitalGauge Description

ValueChanged

TextChanged

 Occurs when the text of the DigitalGauge is changed.