Siticone Logo
Siticone UI
DOCS
v2025.12.15
Docs Radial Gauge

Siticone Radial Gauge

The SiticoneRadialGauge provides a classic, highly reliable radial instrument visualization. It supports various needle styles, colored ranges (zones), and configurable scale properties, making it suitable for industrial, automotive, or general-purpose applications.

Values & Scale

Properties for setting the gauge's measurement range and current value.

Property Type Description & Usage Example
Value float gauge.Value = 50; The current reading. Updates are animated.
MinimumValue float gauge.MinimumValue = 0; Start of the scale.
MaximumValue float gauge.MaximumValue = 100; End of the scale.

Appearance & Style

Customize the gauge's overall look and feel.

Property Type Description & Usage Example
GaugeStyle RadialGaugeStyle gauge.GaugeStyle = RadialGaugeStyle.Modern; Presets: Classic, Modern, Speedometer, Industrial, Automotive.
DialBackgroundColor Color gauge.DialBackgroundColor = Color.WhiteSmoke; Color of the gauge face.
ScaleColor Color gauge.ScaleColor = Color.Gray; Color of the scale arc.
ShowOuterBorder bool gauge.ShowOuterBorder = true; Displays a border ring around the gauge.

Needle Configuration

Customize the indicator needle.

Property Type Description & Usage Example
NeedleType RadialGaugeNeedleType gauge.NeedleType = RadialGaugeNeedleType.Arrow; Styles: Classic, Modern, Triangular, Arrow, Line.
NeedleColor Color gauge.NeedleColor = Color.Red; Color of the needle.

Scale Zones

Configure colored regions on the scale (e.g., Redline).

Property Type Description & Usage Example
ShowColorZones bool gauge.ShowColorZones = true; Enables colored scale zones.
RedZoneStart float gauge.RedZoneStart = 80; Start value for the red (danger) zone.
YellowZoneStart float gauge.YellowZoneStart = 60; Start value for the yellow (warning) zone.

Public Methods

SetValue(float, bool)
// Sets the value with optional animation.
gauge.SetValue(75, true);
Reset()
// Resets the value to MinimumValue.
gauge.Reset();

Events

Events Wiring
// 1. ValueChanged Event
gauge.ValueChanged += (s, e) => 
{
                Console.WriteLine($"Value: {e.NewValue}");
};

// 2. Zone Entered Events
gauge.EnteredRedZone += (s, e) => 
{
                MessageBox.Show("Warning: Red Zone!");
};

Designer & Smart Tags

Visual Studio integration features.

Feature Description
Themes Classic Speedometer: Traditional car gauge.
Industrial: Rugged look.
Modern Minimal: Clean design.
Actions Test Redline: Simulates needle moving to red zone.

Detailed Usage Examples

Example 1: Classic Speedometer

A traditional automotive speedometer configuration.

C# - Speedometer
private void SetupSpeedometer()
{
    gauge.GaugeStyle = RadialGaugeStyle.Speedometer;
    gauge.UnitText = "MPH";
    gauge.MaximumValue = 120;
    
                // Redline
    gauge.RedZoneStart = 100;
    gauge.YellowZoneStart = 80;
    gauge.ShowColorZones = true;
}

Example 2: Industrial Pressure Gauge

A simple, high-contrast gauge for industrial applications.

C# - Pressure
private void SetupPressure()
{
    gauge.GaugeStyle = RadialGaugeStyle.Industrial;
    gauge.UnitText = "PSI";
    gauge.MaximumValue = 200;
    
                // Simple needle
    gauge.NeedleType = RadialGaugeNeedleType.Triangular;
    gauge.NeedleColor = Color.Black;
}