Siticone Material GroupBox

The SiticoneMaterialGroupBox is a modern container control designed for .NET 8+ applications, inspired by contemporary UI design languages. It features a distinct, solid header bar for the title, customizable colors, and optional icon support. It provides a clean, structured way to group controls that feels native to modern applications like Windows Settings or Azure dashboards.

Header Styling

Customize the appearance of the prominent title bar.

Property	Type	Description & Usage Example
`HeaderColor`	Color	box.HeaderColor = Color.FromArgb(240, 242, 245); The background color of the top header strip.
`HeaderHeight`	int	box.HeaderHeight = 40; The vertical height of the header in pixels.
`TitleTextColor`	Color	box.TitleTextColor = Color.Black; The color of the text displayed in the header.
`TitleFont`	Font	box.TitleFont = new Font("Segoe UI", 10f); The font used for the header text.

Content & Border

Define the look of the main container area.

Property	Type	Description & Usage Example
`FillColor`	Color	box.FillColor = Color.White; The background color of the content area.
`LineColor`	Color	box.LineColor = Color.LightGray; The color of the outer border.
`LineThickness`	int	box.LineThickness = 1; The width of the border line in pixels.
`BorderRadius`	int	box.BorderRadius = 0; Controls the roundness of the corners. Set to 0 for sharp, rectangular corners (Material style).

Layout Options

Configure how text and icons are positioned within the header.

Property	Type	Description & Usage Example
`TitleAlignment`	TitleAlignments	box.TitleAlignment = TitleAlignments.Center; Horizontal alignment of the title: `Left`, `Center`, or `Right`.
`TitleOffset`	int	box.TitleOffset = 15; Additional padding from the edge for the title text.
`TitleIcon`	Image	box.TitleIcon = Properties.Resources.Icon; Optional icon image displayed next to the title text.
`IconSize`	Size	box.IconSize = new Size(16, 16); The display size of the title icon.

Designer Support

Includes a robust Smart Tag panel for rapid theming and configuration.

Category	Features
`Theme Presets`	Apply curated styles instantly: Modern Light/Dark, Ocean Blue, Mint Green, Sunset Orange, and many more.
`Quick Config`	Access common properties like Header Color, Border, and Title Font directly from the design surface.
`Utilities`	Copy/Paste Settings: Replicate complex styles across multiple group boxes with a single click. Reset to Default: Restore factory settings.

Detailed Usage Examples

Example 1: Settings Group

A standard configuration for a settings panel with a clean, gray header.

C# - Settings Panel

private SiticoneMaterialGroupBox CreateSettingsGroup()
{
                var gb = new SiticoneMaterialGroupBox
    {
        Text = "General Settings",
        Size = new Size(400, 250),
        
                // Modern Gray Header
        HeaderColor = Color.FromArgb(245, 245, 245),
        HeaderHeight = 35,
        TitleTextColor = Color.FromArgb(60, 60, 60),
        TitleFont = new Font("Segoe UI Semibold", 10f),
        
                // Content Area
        FillColor = Color.White,
        LineColor = Color.FromArgb(220, 220, 220)
    };
    
                return gb;
}

Example 2: Alert Box

Using a colorful theme (Red/Error) to create an alert or warning section.

C# - Alert Box

private void ApplyAlertStyle(SiticoneMaterialGroupBox gb)
{
    gb.Text = "Critical Error";
    
                // Red Header
    gb.HeaderColor = Color.FromArgb(211, 47, 47);
    gb.TitleTextColor = Color.White;
    
                // Light Red Body
    gb.FillColor = Color.FromArgb(255, 235, 238);
    gb.LineColor = Color.FromArgb(229, 57, 53);
    
    gb.TitleIcon = SystemIcons.Error.ToBitmap();
}