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
// Sets the value with optional animation.
gauge.SetValue(75, true);
// Resets the value to MinimumValue.
gauge.Reset();
Events
// 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.
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.
private void SetupPressure()
{
gauge.GaugeStyle = RadialGaugeStyle.Industrial;
gauge.UnitText = "PSI";
gauge.MaximumValue = 200;
// Simple needle
gauge.NeedleType = RadialGaugeNeedleType.Triangular;
gauge.NeedleColor = Color.Black;
}