ModernDialogs.WinForms 2.0.0

ModernDialogs.WinForms

A highly polished, hardware-accelerated MessageBox and Toast Notification library for Windows Forms applications.

ModernDialogs.WinForms completely replaces legacy, rigid system dialogs with ultra-smooth 32-bit alpha-blended layered forms, dynamic dark/light theme switching, 5 built-in design aesthetics, countdown progress timers, and automatic vertical stacking queues.

Design Styles • Installation • Quick Start • API Reference

🚀 Key Features

• ✨ True 32-Bit Premultiplied Alpha: Pixel-perfect rounded corners and smooth anti-aliased drop shadows using native Windows DWM layered compositing.
• 🍞 Non-Blocking Toast Notifications: Smooth slide/fade entrance, interactive close button, and real-time visual progress countdown timers.
• 📚 Smart Stacking Queue: Multiple toasts automatically stack vertically without overlapping or stealing keyboard/mouse focus from parent forms.
• 🎨 5 Designer Styles: Switch seamlessly between DashboardPremium, FluentGlass, MaterialFlat, SoftNeumorphic, and CyberpunkIndustrial presets.
• 🌓 Global Dark / Light Modes: Instant theme-mode switching across all active and future dialogs with a single configuration flag.
• 📦 Zero External Dependencies: 100% native C# and standard Windows Forms APIs without heavy 3rd-party UI frameworks.
• 🔄 Broad Target Compatibility: Native multi-targeting for classic .NET Framework 4.7.2 / 4.8 up through modern .NET 6.0 / 8.0 Windows.

🎨 Design Styles

📦 Installation

.NET CLI

dotnet add package ModernDialogs.WinForms

Package Manager Console

Install-Package ModernDialogs.WinForms

Visual Studio GUI

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

⚡ Quick Start

1. Global Theme & Style Configuration

Set your application-wide aesthetic once (e.g., in Program.cs or Form_Load):

using Podargus.UI.Controls.WinForms.ModernDialogs.Enums;
using Podargus.UI.Controls.WinForms.ModernDialogs.Helpers;

// Configure global appearance
ModernNotificationConfig.Theme = NotificationThemeMode.Dark;
ModernNotificationConfig.Style = NotificationDesignStyle.DashboardPremium;

2. Modern Message Box Usage

Display modal message dialogs with custom icons and button configurations:

using Podargus.UI.Controls.WinForms.ModernDialogs;
using Podargus.UI.Controls.WinForms.ModernDialogs.Enums;

// Simple Info Alert
ModernMessageBox.Show(
    "Your background compilation completed with 0 errors.", 
    "Build Succeeded", 
    MessageBoxButtons.OK, 
    ModernMessageIcon.Info);

// Confirmation Dialog with Return Handling
ModernDialogResult result = ModernMessageBox.Show(
    "This action will permanently purge cached assets. Continue?",
    "Confirm Deletion",
    MessageBoxButtons.YesNo,
    ModernMessageIcon.Warning);

if (result == ModernDialogResult.Yes)
{
    // Execute deletion logic
}

3. Floating Toast Notification Usage

Display non-blocking in-app notifications that auto-dismiss and stack cleanly:

using Podargus.UI.Controls.WinForms.ModernDialogs;
using Podargus.UI.Controls.WinForms.ModernDialogs.Enums;

// Success Notification (3 second auto-dismiss)
ModernToast.Show("Database Saved", "Record #41829 committed to SQL cluster.", ToasterType.Success, 3000);

// Error Notification (4 second auto-dismiss)
ModernToast.Show("Socket Exception", "Failed to bind Port 5000.", ToasterType.Error, 4000);

// Multi-Toast Stacking (They automatically stack vertically)
ModernToast.Show("Download 1/2", "Fetching manifest...", ToasterType.Info, 2500);
ModernToast.Show("Download 2/2", "Package extraction completed!", ToasterType.Success, 3500);

⚙️ Specifications

📄 License

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

📝 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.