skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
syncfusion/winforms-ui-components-skills84 installs

syncfusion-winforms-radial-gauge

Guide for implementing Syncfusion Gauge controls in Windows Forms applications. Use when creating data visualization gauges such as RadialGauge for circular displays (speedometers, temperature dials), LinearGauge for horizontal/vertical bars and progress indicators, or DigitalGauge for LED-style alphanumeric displays. Covers dashboard gauges, instrument panels, real-time monitoring, and KPI displays with needles, ranges, and scales.

How do I install this agent skill?

npx skills add https://github.com/syncfusion/winforms-ui-components-skills --skill syncfusion-winforms-radial-gauge
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a legitimate technical documentation package for Syncfusion Windows Forms Gauge controls. It contains implementation guides, API references, and code examples for Radial, Linear, and Digital gauges. No security risks, malicious patterns, or obfuscation were detected. The skill correctly uses placeholders for sensitive information like license keys and database connection strings.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Implementing Gauges

When to Use This Skill

Use this skill when the user needs to implement Syncfusion Gauge controls in a Windows Forms application. This skill covers three gauge types for different visualization needs:

RadialGauge Use Cases

  1. Speedometers and tachometers - Vehicle instrumentation, RPM displays
  2. Temperature gauges - HVAC controls, system monitoring, weather displays
  3. Pressure gauges - Industrial monitoring, tire pressure, hydraulic systems
  4. Progress indicators - Circular progress for loading, completion percentage
  5. KPI dashboards - Performance metrics with color-coded ranges
  6. Dial controls - Volume, brightness, or any rotary control visualization
  7. Compass displays - Navigation, orientation indicators
  8. Clock faces - Analog time displays with custom styling

LinearGauge Use Cases

  1. Progress bars - Task completion, download progress, loading status
  2. Level indicators - Battery level, fuel gauge, volume meters
  3. Slider visualizations - Temperature sliders, adjustment controls
  4. Horizontal meters - Audio levels, signal strength, capacity indicators
  5. Vertical meters - Building height indicators, elevator position
  6. Thermometer displays - Temperature scales, medical thermometers
  7. Timeline indicators - Project timelines, milestone tracking

DigitalGauge Use Cases

  1. Digital clocks - Time displays, countdown timers, stopwatches
  2. Counters - Visitor counters, production counters, score displays
  3. Alphanumeric status - System codes, product IDs, status messages
  4. LED displays - Retro-style indicators, industrial displays
  5. Price displays - Gas station prices, retail pricing
  6. Measurement readouts - Digital multimeters, sensor readings

When NOT to use: For simple text displays without gauge visualization, use standard Label or TextBox controls. For charts and graphs, use Chart controls.

Component Overview

Syncfusion provides three gauge controls for data visualization in Windows Forms:

1. RadialGauge

Visualizes values on a circular or arc scale with customizable needles, ranges, and frames.

Key Features:

  • 4 frame types: FullCircle, HalfCircle, QuarterCircle, Fill
  • Multiple needles support
  • Color-coded ranges for visual thresholds
  • Customizable scales, ticks, and labels
  • Gradient backgrounds and styling
  • Custom needle styles (Default, Advanced, Pointer)

2. LinearGauge

Visualizes values on a linear scale (horizontal or vertical) with pointer indicators.

Key Features:

  • Horizontal and vertical orientations
  • Pointer placement (Top, Center, Bottom)
  • Color-coded ranges
  • Major and minor tick marks
  • Value indicator bars
  • Gradient styling

3. DigitalGauge

Displays alphanumeric characters in LED/digital format.

Key Features:

  • 4 character types: DotMatrix, SevenSegment, FourteenSegment, SixteenSegment
  • Configurable character count
  • Segment spacing control
  • Invisible segment display option
  • Rounded corners support

All gauges support:

  • Visual themes (9 built-in + custom)
  • Data binding for real-time updates
  • Custom renderers for complete visual control
  • Professional styling options

Documentation and Navigation Guide

Installation and Setup

📄 Read: references/installation-and-setup.md

When user needs to set up gauge controls for the first time. Covers:

  • Assembly references (Syncfusion.Gauge.Windows.dll, Syncfusion.Shared.Base.dll)
  • NuGet package installation
  • Namespace imports (Syncfusion.Windows.Forms.Gauge)
  • Framework support (.NET 4.5+, .NET 6.0-8.0)
  • Deployment requirements
  • Toolbox configuration
  • Sample browser location

RadialGauge (Circular Gauges)

📄 Read: references/radial-gauge.md

When user needs circular, arc, or dial-style gauges. Covers:

  • Frame types (FullCircle, HalfCircle, QuarterCircle, Fill)
  • Designer and code-based setup
  • Scales and labels (placement, orientation, colors)
  • Ticks (major/minor configuration, heights, colors)
  • Needles (single and multiple, styles, colors)
  • Ranges (color-coded value ranges with start/end)
  • Scaling divisions (MajorDifference, MinorDifference)
  • StartAngle and SweepAngle customization
  • Frame appearance (gradients, arc colors)
  • Label customization with DrawLabel event
  • Performance optimization tips

LinearGauge (Bar/Slider Gauges)

📄 Read: references/linear-gauge.md

When user needs horizontal or vertical bar-style gauges. Covers:

  • Frame types (Horizontal, Vertical)
  • Designer and code-based setup
  • Scales and label configuration
  • Tick marks (major/minor)
  • Pointer placement options
  • Needle display and styling
  • Ranges (LinearRange with colors)
  • Value indicator positioning
  • Frame appearance customization
  • Complete orientation examples

DigitalGauge (LED Display)

📄 Read: references/digital-gauge.md

When user needs LED-style alphanumeric displays. Covers:

  • Character types (DotMatrix, SevenSegment, FourteenSegment, SixteenSegment)
  • Designer and code-based setup
  • Character count limiting
  • Segment spacing configuration
  • ShowInvisibleSegments property
  • RoundCornerRadius for rounded edges
  • Value property for string display
  • Frame customization
  • Examples for each character type

Visual Themes and Styling

📄 Read: references/visual-themes.md

When user wants to apply professional themes or custom styling. Covers:

  • VisualStyle property (applies to all 3 gauge types)
  • Built-in themes (Blue, Black, Silver, Metro, Office2016 variants)
  • Custom theme creation (ThemeBrush collections)
  • Color customization properties
  • Design-time theme setup
  • Theme-specific examples for each gauge type
  • Consistent application-wide theming

Custom Renderers

📄 Read: references/custom-renderers.md

When user needs complete control over gauge rendering and appearance. Covers:

  • IRadialGaugeRenderer interface
  • ILinearGaugeRenderer interface
  • Creating custom renderer classes
  • DrawOuterArc, DrawNeedle, DrawLabel, DrawRanges methods
  • Renderer property assignment
  • Advanced customization scenarios
  • Complete custom renderer examples

Data Binding

📄 Read: references/data-binding.md

When user needs real-time data updates or database-driven gauges. Covers:

  • DataSource property configuration
  • DisplayMember (column mapping)
  • DisplayRecordIndex (row mapping)
  • High-frequency data updates
  • Real-time monitoring scenarios
  • Performance considerations
  • Complete binding examples for all gauge types

Quick Start Examples

RadialGauge: Speedometer

using Syncfusion.Windows.Forms.Gauge;

// Create RadialGauge
RadialGauge speedometer = new RadialGauge();
speedometer.Size = new Size(300, 300);
speedometer.Location = new Point(20, 20);

// Configure gauge properties
speedometer.MinimumValue = 0;
speedometer.MaximumValue = 200;
speedometer.MajorDifference = 20;
speedometer.MinorDifference = 5;
speedometer.Value = 60;

// Set frame type
speedometer.FrameType = FrameType.HalfCircle;

// Configure appearance
speedometer.ShowNeedle = true;
speedometer.NeedleStyle = NeedleStyle.Advanced;
speedometer.GaugeLabel = "Speed (MPH)";

// Add color-coded ranges
Range range1 = new Range();
range1.StartValue = 0;
range1.EndValue = 80;
range1.Color = Color.Green;
range1.Height = 10;
speedometer.Ranges.Add(range1);

Range range2 = new Range();
range2.StartValue = 80;
range2.EndValue = 150;
range2.Color = Color.Yellow;
range2.Height = 10;
speedometer.Ranges.Add(range2);

Range range3 = new Range();
range3.StartValue = 150;
range3.EndValue = 200;
range3.Color = Color.Red;
range3.Height = 10;
speedometer.Ranges.Add(range3);

// Add to form
this.Controls.Add(speedometer);

LinearGauge: Battery Level

using Syncfusion.Windows.Forms.Gauge;

// Create LinearGauge
LinearGauge batteryLevel = new LinearGauge();
batteryLevel.Size = new Size(300, 125);
batteryLevel.Location = new Point(20, 20);

// Set horizontal orientation
batteryLevel.LinearFrameType = LinearFrameType.Horizontal;

// Configure gauge properties
batteryLevel.MinimumValue = 0;
batteryLevel.MaximumValue = 100;
batteryLevel.MajorDifference = 20;
batteryLevel.MinorTickCount = 3;
batteryLevel.Value = 75;

// Configure appearance
batteryLevel.ShowNeedle = true;
batteryLevel.PointerPlacement = Placement.Center;

// Add color-coded ranges
LinearRange lowRange = new LinearRange();
lowRange.StartValue = 0;
lowRange.EndValue = 20;
lowRange.Color = Color.Red;
lowRange.Height = 8;
batteryLevel.Ranges.Add(lowRange);

LinearRange normalRange = new LinearRange();
normalRange.StartValue = 20;
normalRange.EndValue = 80;
normalRange.Color = Color.Yellow;
normalRange.Height = 8;
batteryLevel.Ranges.Add(normalRange);

LinearRange highRange = new LinearRange();
highRange.StartValue = 80;
highRange.EndValue = 100;
highRange.Color = Color.Green;
highRange.Height = 8;
batteryLevel.Ranges.Add(highRange);

// Add to form
this.Controls.Add(batteryLevel);

DigitalGauge: LED Clock

using Syncfusion.Windows.Forms.Gauge;

// Create DigitalGauge
DigitalGauge digitalClock = new DigitalGauge();
digitalClock.Size = new Size(250, 100);
digitalClock.Location = new Point(20, 20);

// Configure character display
digitalClock.CharacterType = CharacterType.SevenSegment;
digitalClock.CharacterCount = 8;
digitalClock.SegmentSpacing = 2.0f;

// Set initial value
digitalClock.Value = DateTime.Now.ToString("HH:mm:ss");

// Configure appearance
digitalClock.ForeColor = Color.Red;
digitalClock.ShowInvisibleSegments = true;

// Add timer to update clock
Timer clockTimer = new Timer();
clockTimer.Interval = 1000; // 1 second
clockTimer.Tick += (s, e) => {
    digitalClock.Value = DateTime.Now.ToString("HH:mm:ss");
};
clockTimer.Start();

// Add to form
this.Controls.Add(digitalClock);

Common Patterns

Pattern 1: Dashboard with Multiple Gauges

// Create dashboard layout
FlowLayoutPanel dashboard = new FlowLayoutPanel();
dashboard.Dock = DockStyle.Fill;

// Temperature gauge (RadialGauge)
RadialGauge tempGauge = new RadialGauge();
tempGauge.MinimumValue = -20;
tempGauge.MaximumValue = 120;
tempGauge.Value = 72;
tempGauge.GaugeLabel = "°F";
tempGauge.FrameType = FrameType.HalfCircle;
dashboard.Controls.Add(tempGauge);

// Fuel level (LinearGauge)
LinearGauge fuelGauge = new LinearGauge();
fuelGauge.LinearFrameType = LinearFrameType.Vertical;
fuelGauge.MinimumValue = 0;
fuelGauge.MaximumValue = 100;
fuelGauge.Value = 45;
dashboard.Controls.Add(fuelGauge);

// Status counter (DigitalGauge)
DigitalGauge statusCounter = new DigitalGauge();
statusCounter.CharacterType = CharacterType.SevenSegment;
statusCounter.Value = "1234";
dashboard.Controls.Add(statusCounter);

this.Controls.Add(dashboard);

Pattern 2: Data-Bound Real-Time Gauge

// Setup data source
DataTable sensorData = new DataTable();
sensorData.Columns.Add("SensorValue", typeof(float));
sensorData.Rows.Add(0);

// Create and bind gauge
RadialGauge sensorGauge = new RadialGauge();
sensorGauge.DataSource = sensorData;
sensorGauge.DisplayMember = "SensorValue";
sensorGauge.DisplayRecordIndex = 0;

// Timer to simulate sensor updates
Timer dataTimer = new Timer();
dataTimer.Interval = 100; // 10 updates per second
dataTimer.Tick += (s, e) => {
    // Update data source (gauge updates automatically)
    sensorData.Rows[0]["SensorValue"] = GetSensorReading();
};
dataTimer.Start();

Pattern 3: Themed Gauge Set

// Apply consistent theme to all gauges
void ApplyTheme(Control.ControlCollection controls, ThemeStyle theme)
{
    foreach (Control control in controls)
    {
        if (control is RadialGauge radial)
            radial.VisualStyle = theme;
        else if (control is LinearGauge linear)
            linear.VisualStyle = theme;
        else if (control is DigitalGauge digital)
            digital.VisualStyle = theme;
            
        if (control.HasChildren)
            ApplyTheme(control.Controls, theme);
    }
}

// Usage
ApplyTheme(this.Controls, ThemeStyle.Office2016Colorful);

Gauge Type Selection Guide

NeedUse This GaugeWhy
Circular display (speedometer style)RadialGaugeNatural for rotary values, intuitive needle movement
Arc/partial circleRadialGauge (HalfCircle/QuarterCircle)Space-efficient, modern dashboard look
Horizontal progress barLinearGauge (Horizontal)Clear left-to-right progression
Vertical level indicatorLinearGauge (Vertical)Natural for height/depth/level visualization
Time display (LED style)DigitalGauge (SevenSegment)Classic digital clock appearance
Alphanumeric status codeDigitalGauge (FourteenSegment/SixteenSegment)Supports letters and numbers
Multiple needles on one dialRadialGauge (EnableCustomNeedles)Compare multiple values on same scale
Fill-based progress indicatorRadialGauge (FrameType.Fill)Visual fill from start to current value

Key Properties Comparison

Common to All Gauges

PropertyTypeDescription
Valuefloat (Radial/Linear) / string (Digital)Current displayed value
MinimumValuefloatMinimum scale value (Radial/Linear only)
MaximumValuefloatMaximum scale value (Radial/Linear only)
DataSourceobjectData source for binding
DisplayMemberstringColumn name for value binding
DisplayRecordIndexintRow index for value binding

RadialGauge Specific

PropertyTypeDescription
FrameTypeFrameTypeFullCircle, HalfCircle, QuarterCircle, Fill
StartAngleintStarting angle of arc (degrees)
SweepAngleintArc span length (degrees)
ShowNeedleboolDisplay pointer needle
VisualStyleThemeStyleTheme: Blue, Black, Silver, Metro, Office2016*, Custom
NeedleStyleNeedleStyleDefault, Advanced, Pointer
EnableCustomNeedlesboolAllow multiple needles
RangesRangeCollectionColor-coded value ranges
MajorDifferencefloatSpacing between major ticks
MinorDifferencefloatSpacing between minor ticks

LinearGauge Specific

PropertyTypeDescription
LinearFrameTypeLinearFrameTypeHorizontal or Vertical
PointerPlacementPlacementTop, Center, Bottom
ShowNeedleboolDisplay pointer
VisualStyleThemeStyleTheme: Blue, Black, Silver, Metro, Office2016*, Custom
RangesLinearRangeCollectionColor-coded value ranges
MajorDifferencefloatSpacing between major ticks
MinorTickCountintNumber of minor ticks between majors

DigitalGauge Specific

PropertyTypeDescription
ValuestringText to display
CharacterTypeCharacterTypeDotMatrix, SevenSegment, FourteenSegment, SixteenSegment
CharacterCountintNumber of characters to display
SegmentSpacingfloatSpacing between characters
ShowInvisibleSegmentsboolShow inactive segments
RoundCornerRadiusintCorner rounding radius
Note: DigitalGauge does not support the VisualStyle property. Use ForeColor and BackColor for styling instead.

Common Use Cases

1. Industrial Dashboard

Scenario: Monitor multiple sensors (pressure, temperature, RPM)
Solution: Multiple RadialGauges with color-coded ranges and real-time data binding

2. Progress Indicator

Scenario: Show task completion percentage
Solution: LinearGauge (Horizontal) or RadialGauge (Fill type) with 0-100 range

3. Digital Clock Display

Scenario: Display current time in LED format
Solution: DigitalGauge with SevenSegment character type, timer for updates

4. Vehicle Instrument Cluster

Scenario: Speedometer, tachometer, fuel gauge
Solution: RadialGauges (HalfCircle for speed/RPM), LinearGauge (Vertical for fuel)

5. System Monitor

Scenario: CPU usage, memory, network speed
Solution: Mix of RadialGauges (percentage dials) and DigitalGauges (numeric readouts)

6. Temperature Control

Scenario: Thermostat with visual temperature display
Solution: RadialGauge (FullCircle) with color ranges (blue=cold, yellow=moderate, red=hot)

Best Practices

  1. Choose appropriate gauge type - RadialGauge for rotary values, LinearGauge for linear progression, DigitalGauge for alphanumeric
  2. Use color-coded ranges - Visual thresholds improve readability (green=good, yellow=warning, red=critical)
  3. Set meaningful scales - Configure Min/Max and MajorDifference to match your data range
  4. Apply consistent themes - Use same VisualStyle across all gauges in application
  5. Optimize real-time updates - Use data binding for frequent updates instead of manual Value setting
  6. Label your gauges - Set GaugeLabel property to clarify what's being measured
  7. Consider performance - For many gauges, use SuspendLayout/ResumeLayout when configuring multiple properties
  8. Test different frame types - HalfCircle and QuarterCircle save space while remaining readable

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/syncfusion/winforms-ui-components-skills/syncfusion-winforms-radial-gauge">View syncfusion-winforms-radial-gauge on skillZs</a>