Siticone Logo
Siticone UI
DOCS
v2025.12.15
Docs Legacy Group Box

Siticone Legacy GroupBox

The SiticoneLegacyGroupBox pays homage to traditional Windows user interfaces while offering modern rendering and customization capabilities. Its distinct feature is the title embedded directly into the top border, often accompanied by a decorative top line. This control is perfect for enterprise applications, configuration dialogs, or any interface requiring a classic, professional structure.

Appearance & Styling

Customize the core visual attributes of the group box container.

Property Type Description & Usage Example
FillColor Color legacyBox.FillColor = Color.White; The background color of the content area.
BorderColor Color legacyBox.BorderColor = Color.Silver; The color of the surrounding border.
BorderThickness int legacyBox.BorderThickness = 1; The width of the border in pixels.
BorderRadius int legacyBox.BorderRadius = 3; The roundness of the corners. Default is 3 for a subtle curve.

Title Customization

Configure how the embedded title text is displayed.

Property Type Description & Usage Example
Text string legacyBox.Text = "Connection Settings"; The header text displayed in the top border gap.
TitleTextColor Color legacyBox.TitleTextColor = Color.Black; The color of the title text.
TitleFont Font legacyBox.TitleFont = new Font("Segoe UI", 9f); The font used for the title text.
TitleAlignment TitleAlign legacyBox.TitleAlignment = TitleAlign.Left; Horizontal alignment of the title: Left, Center, or Right.
TitlePadding int legacyBox.TitlePadding = 10; Spacing on the left and right of the title text.

Top Line Styling

A unique feature of the legacy style is the decorative line that often runs through or above the title.

Property Type Description & Usage Example
TopLineColor Color legacyBox.TopLineColor = Color.LightGray; The color of the line segment passing through the title area.
TopLineThickness int legacyBox.TopLineThickness = 1; The thickness of the top decorative line.

Designer Support

Includes a Smart Tag panel for rapid configuration and theming.

Category Features
Theme Presets Instantly apply styles: Default, Office (modern gray), Classic (system colors).
Quick Config Access common properties like Title Color, Border, and Alignment directly from the design surface.

Detailed Usage Examples

Example 1: Standard Preferences Group

A clean, classic group box for application settings.

C# - Preferences Group
private SiticoneLegacyGroupBox CreatePreferencesGroup()
{
                var gb = new SiticoneLegacyGroupBox
    {
        Text = "General Preferences",
        Size = new Size(300, 150),
        
                // Classic Styling
        FillColor = Color.White,
        BorderColor = Color.FromArgb(200, 200, 200),
        BorderRadius = 2,
        
                // Title Styling
        TitleTextColor = Color.DarkBlue,
        TitleFont = new Font("Tahoma", 9f, FontStyle.Bold),
        TitleAlignment = SiticoneLegacyGroupBox.TitleAlign.Left
    };
    
                return gb;
}

Example 2: Office-Style Section

Applying an "Office" theme look programmatically.

C# - Office Style
private void ApplyOfficeTheme(SiticoneLegacyGroupBox gb)
{
    gb.FillColor = Color.FromArgb(240, 240, 240); // Light Gray Background
    gb.BorderColor = Color.FromArgb(170, 170, 170);
    gb.TopLineColor = Color.FromArgb(170, 170, 170);
    
    gb.TitleTextColor = Color.FromArgb(60, 60, 60);
    gb.TitleFont = new Font("Segoe UI", 9f);
    
    gb.Invalidate();
}