ModernButtons.WinForms 1.1.0

ModernButtons.WinForms

Stop using ugly, 3D gray inputs. Upgrade to anti-aliased, hardware-accelerated Modern Buttons for Windows Forms.

🛑 The Problem with Standard WinForms Buttons

The default WinForms Button is infamous for its harsh gray borders and rigid layout. Achieving smooth rounded corners, custom geometry, image-text relations, and dynamic dark mode styling using the native control is virtually impossible without breaking the click boundaries or losing native routing support.

🟢 The Podargus Solution

ModernButtons.WinForms provides a premium, zero-dependency input. It completely overrides the GDI+ drawing engine to deliver flawless geometry, tactile hover/press animations, and an advanced Layout Engine, while perfectly maintaining inheritance from the native System.Windows.Forms.Button class.

This means features like DialogResult, AcceptButton, CancelButton, AutoEllipsis, and TextImageRelation work perfectly out of the box!

🚀 Key Features

• 💠 10 Unique Geometric Shapes: Change the physical shape instantly using the Style property (Pill, Leaf, Hexagon, TearDrop, Ghost, Elevated3D, etc.).
• 🎨 5 Core Color Palettes: Full support for the Podargus Design Matrix (Dark/Light × DashboardPremium, FluentGlass, MaterialFlat, SoftNeumorphic, Cyberpunk) using the ColorStyle property.
• 🖼️ Advanced Layout Engine: Flawless support for TextImageRelation, ImageAlign, and TextAlign alongside native AutoEllipsis and clipped BackgroundImage support.
• 🎛️ Extreme Customization: Set ColorStyle to Custom to unlock 16 independent color properties controlling the Background, Text, and Borders across Normal, Hover, Pressed, and Disabled states.
• ✨ Smooth Vector Graphics: Anti-aliased corner rendering with globally customizable BorderRadius and BorderWidth.
• ⛔ Perfect Disabled States: Automatically calculates sleek grayscale layouts for backgrounds, text, and even foreground images when Enabled = false.

📦 Installation

Package Manager Console

Install-Package ModernButtons.WinForms

### .NET CLI
```bash
dotnet add package ModernButtons.WinForms

⚡ Quick Start & Code Examples

1. Global Theme Configuration

Instantly switch the look of your inputs to match your application's aesthetic.

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

btnSubmit.Theme = ThemeMode.Dark;
btnSubmit.ColorStyle = ButtonDesignStyle.DashboardPremium;
btnSubmit.Style = ButtonAppearanceStyle.Pill; // Changes the shape!

2. Creating an Image + Text Action Button

Creates a solid, glowing accent button with an icon perfectly positioned next to the text.

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

var btnSave = new ModernButton
{
    Text = "Save Changes",
    Image = Properties.Resources.SaveIcon,
    TextImageRelation = TextImageRelation.ImageBeforeText,
    IsPrimary = true,
    Theme = ThemeMode.Dark,
    ColorStyle = ButtonDesignStyle.FluentGlass,
    Style = ButtonAppearanceStyle.Leaf, // Beautiful asymmetric rounded corners
    Size = new Size(160, 45)
};

btnSave.Click += (s, e) => MessageBox.Show("Saved successfully!");
this.Controls.Add(btnSave);

3. Creating a Ghost Outline Button

Creates a transparent "Ghost" button that acts as a secondary/outline button until hovered..

var btnCancel = new ModernButton
{
    Text = "Cancel",
    IsPrimary = false,
    DialogResult = DialogResult.Cancel, // Works natively with WinForms!
    Theme = ThemeMode.Dark,
    Style = ButtonAppearanceStyle.Ghost, // Invisible background until hover
    ColorStyle = ButtonDesignStyle.DashboardPremium,
    Size = new Size(100, 40)
};

this.Controls.Add(btnCancel);

4. Extreme Custom Branding

Need to match exact corporate hex codes for every interaction state? Unlock extreme configuration using ColorStyle.Custom.

var btnBrand = new ModernButton
{
    Text = "Custom Brand Button",
    ColorStyle = ButtonDesignStyle.Custom,
    Style = ButtonAppearanceStyle.Hexagon, // Sharp geometric shape
    
    // Base Colors
    CustomPrimaryColor = Color.Crimson,
    CustomTextColor = Color.White,
    CustomBorderColor = Color.DarkRed,
    
    // Hover Colors
    CustomHoverColor = Color.LightCoral,
    CustomHoverTextColor = Color.White,
    
    // Pressed Colors
    CustomPressedColor = Color.Maroon,
    CustomPressedTextColor = Color.LightGray,
    
    BorderWidth = 2f,
    BorderRadius = 10
};
this.Controls.Add(btnBrand);

🎨 Color Palettes (ColorStyle)

🎨 Appearance & Color Matrix

⚙️ Specifications

📄 License

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

Maintained by Podargus

Building zero-dependency, ultra-performance developer workflows and hardware-accelerated UI components.