ModernTrackBar.WinForms 2.0.0

ModernTrackBar.WinForms

A highly polished, high-performance, and deeply customizable TrackBar / Slider control for Windows Forms applications.

ModernTrackBar.WinForms completely replaces the legacy, rigid system control with ultra-smooth, anti-aliased GDI+ vector mapping, beautiful linear gradients, hardware-friendly double buffering, dynamic value displays, and a robust theme engine built for modern desktop design ecosystems.

Themes • Installation • Quick Start • API Reference

🚀 Key Features

• ✨ Advanced GDI+ Drawing: Fully anti-aliased geometry with crisp, hardware-accelerated double-buffered painting to entirely eliminate control flicker.
• 🎨 Dynamic Linear Gradients: Create gorgeous multi-color tracks that shift visually alongside the slider's thumb.
• 💬 Live Floating Value Display: An interactive real-time text layout engine that tracks and previews numeric value changes dynamically.
• ⚡ Responsive Micro-Interactions: Polished visual feedback animations engineered for hover, focus, press, and active control states.
• 🎭 Flexible Theme Engine: Ship instantly using beautiful built-in visual profiles or unlock full custom token configurations.
• 🛠️ First-Class Designer Support: Drop it directly into the Visual Studio Forms Designer canvas with full property serialization support.
• 📦 Zero External Dependencies: Built natively using standard .NET, System.Drawing, and WinForms APIs without heavy UI wrappers.
• 🔄 Broad Target Compatibility: Native multi-targeting for classic .NET Framework up through modern .NET Windows environments.

🎨 Built-in Themes

📦 Installation

.NET CLI

dotnet add package ModernTrackBar.WinForms

Package Manager Console

Install-Package ModernTrackBar.WinForms

Visual Studio GUI

1. Right-click your project solution and select Manage NuGet Packages.
2. Search for ModernTrackBar.WinForms under the Browse tab.
3. Select the latest stable version and click Install.

⚡ Quick Start

🏎️ Designer Workflow

1. Open your Windows Forms project workspace in Visual Studio.
2. Open your target Form or UserControl file within the Design View canvas.
3. Open your Toolbox (Ctrl + Alt + X) and locate ModernTrackBar.
4. Drag and drop the control directly onto the design interface canvas.
5. Tailor performance and visual style properties live directly through the native Properties Window.

💻 Programmatic Workflow

using System;
using System.Drawing;
using System.Windows.Forms;
using Podargus.UI.Controls.WinForms;

namespace MyDashboardApp
{
    public partial class MainDashboard : Form
    {
        private ModernTrackBar _volumeSlider;

        public MainDashboard()
        {
            InitializeComponent();
            InitializeCustomControls();
        }

        private void InitializeCustomControls()
        {
            // Instantiate and configure visual parameters
            _volumeSlider = new ModernTrackBar
            {
                Location = new Point(30, 45),
                Size = new Size(350, 60),
                Minimum = 0,
                Maximum = 100,
                Value = 75,
                Theme = TrackBarTheme.NeonBlue,
                ShowValueTooltip = true
            };

            // Bind native state interactions 
            _volumeSlider.ValueChanged += VolumeSlider_ValueChanged;

            // Mount directly into the form control tree hierarchy
            Controls.Add(_volumeSlider);
        }

        private void VolumeSlider_ValueChanged(object sender, EventArgs e)
        {
            Console.WriteLine($"System Volume adjusted to: {_volumeSlider.Value}%");
        }
    }
}

🔧 API Reference

Configuring the Range Matrix

Easily define control limitations, track boundaries, and baseline default offsets directly:

_volumeSlider.Minimum = 0;   // Define the lowest baseline bounds value
_volumeSlider.Maximum = 1000; // Define the absolute target peak value
_volumeSlider.Value = 500;   // Assign the active slider handle location value

Theme Engine Control

Instantly swap presets programmatic tracking behaviors seamlessly:

// Apply pre-configured visual style mappings
_volumeSlider.Theme = TrackBarTheme.EmeraldGreen;

// Explicitly unlock structural theme properties for runtime overrides
_volumeSlider.Theme = TrackBarTheme.Custom;

Floating Tooltip Interactivity

Toggle the real-time layout value indicator tracking behavior during user drag interaction steps:

_volumeSlider.ShowValueTooltip = true;  // Renders the floating tooltip on interaction
_volumeSlider.ShowValueTooltip = false; // Hides the tooltip completely

⚙️ Specifications

📄 License

This framework utility is securely distributed under the MIT License. Check out the accompanying LICENSE document asset within the repository for commercial application rights and legal usage boundaries.

📝 Release Notes

v2.0.0

• Rebrand: Transitioned under Podargus (formerly GRIT).
• Namespace: Root namespace updated to Podargus.UI.WinForms.
• Performance: Performance and rendering pipeline stability enhancements.

Developed under the Podargus

Building zero-dependency, ultra-performance developer workflows and premium component layouts.

📢 Brand Notice: This package has officially transitioned from GRIT to Podargus. All future updates, performance enhancements, and developer tooling are maintained under the official Podargus.