ModernProgressRing.WinForms 1.0.0

ModernProgressRing.WinForms

An ultra-smooth, hardware-accelerated circular progress bar and indeterminate loading spinner for Windows Forms.

ModernProgressRing Theme Demo

ModernProgressRing Animation Demo

Overview

ModernProgressRing.WinForms is a high-performance, modern replacement for the traditional blocky WinForms ProgressBar.

Engineered with anti-aliased GDI+ surface vector mapping, it supports both determinate tracking (with 60 FPS smooth ease-out value transitions) and indeterminate mode (an infinite rotating loading spinner with dynamic sweep arcs).

Built for:

• .NET Framework 4.7.2+
• .NET 6.0 Windows
• .NET 8.0+ Windows

🚀 Key Features

• ✨ Dual Operating Modes: Seamlessly toggle between Determinate (0–100% metric tracking) and Indeterminate (infinite loading spinner).
• 🏎️ Smooth 60 FPS Value Interpolation: Progress values animate smoothly between changes using built-in ease-out tweening.
• 🎨 2 Theme Modes & 5 Core Styles: Full support for the GRIT Design Matrix (Dark/Light × DashboardPremium, FluentGlass, MaterialFlat, SoftNeumorphic, Cyberpunk).
• 🌈 Dual-Tone Gradient Trails: Renders vivid linear gradient sweeps along active progress arcs without pixel clipping.
• 🛠️ Full Visual Studio Designer Support: Real-time design canvas preview, live property updates, and full toolbox serialization.
• 📦 Zero External Dependencies: Built with pure C# and native .NET Drawing assemblies.

🎨 Theme & Style Matrix

📦 Installation

Package Manager Console

Install-Package ModernProgressRing.WinForms

.NET CLI

dotnet add package ModernProgressRing.WinForms

⚡ Quick Start

1. Designer Workflow

1. Open your Form in the Visual Studio Designer.
2. Locate ModernProgressRing in the Toolbox (Ctrl + Alt + X).
3. Drag and drop it onto the canvas and customize colors and styles in the Properties Window.

2. Programmatic Usage

Percentage Progress Mode (Determinate)

using GRIT.UI.Controls.WinForms.ProgressRing;
using GRIT.UI.Controls.WinForms.ProgressRing.Enums;

var progressRing = new ModernProgressRing
{
    Size = new Size(140, 140),
    ThemeMode = ThemeMode.Dark,
    ControlStyle = ProgressStyle.DashboardPremium,
    RingThickness = 12f,
    Minimum = 0,
    Maximum = 100,
    Value = 75,                // Animates smoothly to 75%
    ShowPercentage = true
};

this.Controls.Add(progressRing);

Infinite Loading Spinner Mode (Indeterminate)

// Turn into an animated loading spinner
progressRing.IsIndeterminate = true;

// When the async operation completes, switch back to progress
await Task.Run(() => DoHeavyWork());

progressRing.IsIndeterminate = false;
progressRing.Value = 100;

🔧 Customization API

Appearance & Geometry

progressRing.RingThickness = 14f;    // Set ring stroke thickness
progressRing.StartAngle = -90f;      // Starting angle (-90 is 12 o'clock)
progressRing.Animated = true;        // Enable/disable smooth value interpolation

Custom Center Text

progressRing.ShowPercentage = true;
progressRing.CustomText = "SYNCING"; // Overrides percentage with custom string

⚙️ Specifications

📄 License

Distributed under the MIT License. See the repository LICENSE file for details.

Developed under the GRIT Ecosystem

Growth • Resilience • Intensity • Tenacity
Building zero-dependency, ultra-performance developer workflows and premium component layouts.