ModernTrackBar.WinForms 1.0.1

ModernTrackBar.WinForms

<div align="center">

<br /><br />

<img src="https://raw.githubusercontent.com/COxRIPMIZO/GRIT.UI.Controls.Assets/main/WinForms/ModernTrackBar.WinForms/ModernTrackerBar.gif" alt="ModernTrackBar Demo" width="750" />

<p align="center"> <b>A highly polished, high-performance, and deeply customizable TrackBar / Slider control for Windows Forms applications.</b> </p>

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.

<p align="center"> <a href="#🎨-built-in-themes">Themes</a> • <a href="#📦-installation">Installation</a> • <a href="#⚡-quick-start">Quick Start</a> • <a href="#🔧-api-reference">API Reference</a> </p>

</div>

🚀 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 GRIT.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.

<div align="center"> <h3>Developed under the GRIT Ecosystem</h3> <p><b>Growth • Resilience • Intensity • Tenacity</b></p> <i>Building zero-dependency, ultra-performance developer workflows and premium component layouts.</i> </div>