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
// 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.
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.
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;
}