Siticone Logo
Siticone UI
DOCS
v2025.12.15
Docs Linear Gauge

Siticone Linear Gauge

The SiticoneLinearGauge is a highly stylized, all-purpose linear meter. It distinguishes itself with unique fill patterns (Striped, Dotted, Wave) and specialized styles like LED and Neon, offering a distinct visual alternative to standard progress bars.

Values & Scale

Core properties for data visualization.

Property Type Description & Usage Example
CurrentValue double gauge.CurrentValue = 42; The current reading. Setting triggers smooth animation.
MinValue double gauge.MinValue = 0; Start of the scale.
MaxValue double gauge.MaxValue = 100; End of the scale.

Visual Style & Themes

Choose from extensive preset styles or customize every aspect.

Property Type Description & Usage Example
BarStyle LinearGaugeStyle gauge.BarStyle = LinearGaugeStyle.Neon; Presets: Classic, Modern, Neon, LED, Glass, Metallic.
FillMode LinearFillMode gauge.FillMode = LinearFillMode.Wave; Pattern of the filled bar: Solid, Gradient, Striped, Dotted, Wave.
Theme LinearGaugeTheme gauge.Theme = LinearGaugeTheme.Fire; Color palette presets: Success, Warning, Rainbow, Fire, Ice.

Segmented Display

Configure the gauge to look like a segmented LED or block meter.

Property Type Description & Usage Example
UseSegments bool gauge.UseSegments = true; Switches from continuous bar to discrete blocks.
SegmentCount int gauge.SegmentCount = 10; Total number of segments.
SegmentSpacing int gauge.SegmentSpacing = 2; Gap between segments in pixels.

Alert Thresholds

Automatic color changing logic for critical values.

Property Type Description & Usage Example
WarningThreshold double gauge.WarningThreshold = 70; Value to trigger Warning color.
CriticalThreshold double gauge.CriticalThreshold = 90; Value to trigger Critical color.

Events

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

// 2. CriticalThresholdReached Event
gauge.CriticalThresholdReached += (s, e) => 
{
    lblStatus.Text = "CRITICAL LEVEL!";
    lblStatus.ForeColor = Color.Red;
};

Designer & Smart Tags

Quickly switch between modes in the designer.

Feature Description
Quick Styles Modern: Smooth, gradient style.
Neon: Glowing edges.
Segmented: LED-style blocks.
Layout Horizontal / Vertical: One-click orientation flip.

Detailed Usage Examples

Example 1: Audio VU Meter

Simulates a stereo VU meter using segmented blocks and gradient colors.

C# - Audio Meter
private void SetupVuMeter()
{
    gauge.BarStyle = LinearGaugeStyle.Segmented;
    gauge.SegmentCount = 20;
    gauge.SegmentSpacing = 1;
    
                // Gradient from Green to Red
    gauge.FillMode = LinearFillMode.Gradient;
    gauge.BarColor = Color.Lime;
    gauge.WarningColor = Color.Yellow;
    gauge.CriticalColor = Color.Red;
    
                // Fast update for audio
    gauge.EnableAnimation = false; 
}

Example 2: Retro Loading Bar

Uses the "Wave" fill mode and Neon style for a retro-game loading bar.

C# - Loading Bar
private void SetupLoadingBar()
{
    gauge.BarStyle = LinearGaugeStyle.Neon;
    gauge.FillMode = LinearFillMode.Wave;
    gauge.BarColor = Color.Cyan;
    gauge.LabelText = "LOADING...";
    
                // Add pulse for "active" feel
    gauge.EnablePulse = true;
}