Siticone Logo
Siticone UI
DOCS
v2025.12.15
Docs Gauge Zone

Siticone Gauge Zone

The SiticoneGaugeZone is a linear, zone-based gauge control that visualizes data across multiple colored segments (e.g., Low, Medium, High). It is perfect for dashboards that need to show status ranges (like server load or temperature zones) in a horizontal layout. It supports animations, gradients, and interactive tooltips.

Zone Configuration

Define the value ranges and appearance for each segment of the gauge.

MethodDescription
AddSectionAdds a new colored zone defined by start and end values.
RemoveSectionRemoves an existing zone section.
ClearSectionsRemoves all zones from the gauge.

Visual Appearance

Customize the overall look, colors, and layout.

PropertyTypeDescription
ThemeEnumPredefined visual themes (e.g., Modern, Neon, Industrial).
GaugeHeightintHeight of the gauge bar in pixels.
CornerRadiusintRounding of the gauge corners.
ZoneGapintSpacing between adjacent zones.
UseGradientboolEnables gradient fills for zones.
GaugeBackColorColorBackground color of the control.

Values & Interaction

Control data input and user interaction.

PropertyTypeDescription
ValuedoubleCurrent value. Triggers animation if enabled.
MinValuedoubleScale minimum.
MaxValuedoubleScale maximum.
InteractiveModeboolAllows changing the value by clicking on the gauge.
ShowTooltipboolDisplays value tooltip on hover.

Visual Effects

Advanced rendering options.

PropertyTypeDescription
EnableShadowboolAdds a drop shadow to the gauge bar.
EnableGlowboolAdds a glow effect to the zones.
Use3DEffectboolEnables 3D rendering (rims, bevels).
AnimateValueboolEnables smooth transitions for value changes.

Public Methods

Setup & Control
// Add a zone
zoneGauge.AddSection(new GaugeSection(0, 50, Color.Green));

// Set Value with animation
zoneGauge.AnimateToValue(75);
// Manual Reset
zoneGauge.ResetValue();

Events

Event Hooks
zoneGauge.ValueChanged += (s, e) => 
{
                Console.WriteLine("Value updated!");
};

zoneGauge.AnimationCompleted += (s, e) =>
{
                Console.WriteLine("Animation finished.");
};

Example: Server Status

C# Setup
public void InitStatusGauge()
{
    zoneGauge.MinValue = 0;
    zoneGauge.MaxValue = 100;
    zoneGauge.Title = "CPU Load";
    
                // Zones
    zoneGauge.ClearSections();
    zoneGauge.AddSection(new GaugeSection(0, 60, Color.Green));
    zoneGauge.AddSection(new GaugeSection(60, 85, Color.Orange));
    zoneGauge.AddSection(new GaugeSection(85, 100, Color.Red));
    
                // Styling
    zoneGauge.Theme = GaugeTheme.Modern;
    zoneGauge.GaugeHeight = 30;
    zoneGauge.CornerRadius = 15;
    
                // Interaction
    zoneGauge.ShowTooltip = true;
    zoneGauge.InteractiveMode = false;
                // Display only
}

Export & Import

The control supports saving its entire configuration to JSON, with optional AES-256 encryption. Right-click the control at runtime to access the saving features.