syncfusion-winforms-status-bar（同步融合 winforms 状态栏）

Implementing Status Bars (StatusBarAdv)

This skill guides the implementation of the Syncfusion StatusBarAdv control in Windows Forms applications. StatusBarAdv is an advanced status bar that displays panels with enhanced backgrounds, appearances, and supports Office2016 themes.

When to Use This Skill

Use this skill when you need to:

• Display application status information at the bottom of forms
• Implement enhanced status bars with gradient backgrounds and styled panels
• Show date/time, culture information, or key states in status panels
• Create professional-looking status bars with Office2016 or Metro themes
• Add custom controls or panels to status bars
• Configure panel alignment and spacing in status displays
• Apply advanced border and background styling to status bars
• Handle status bar property change events

Component Overview

StatusBarAdv is an advanced status bar control that extends the standard Windows Forms StatusBar with:

• StatusBarAdvPanel Collection: Add multiple panels with custom content and styling
• Enhanced Backgrounds: Gradient, pattern, and solid color options using BrushInfo
• Office2016 Themes: Colorful, White, Black, and DarkGray theme support
• Border Customization: 2D and 3D border styles with custom colors
• Panel Alignment: Center, Near, Far, and custom positioning options
• Auto-Sizing: Automatic height adjustment for panels
• Metro Style: Modern flat design option
• Sizing Grip: Resizable form indicator
• Child Controls: Add any WinForms control to the status bar

Assembly: Syncfusion.Tools.Windows Dependencies: Syncfusion.Shared.Base, Syncfusion.Tools.Windows Namespace: Syncfusion.Windows.Forms.Tools

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

When to read: First time implementing StatusBarAdv, setting up assemblies, or creating basic status bars.

• Assembly requirements and installation
• NuGet package installation
• Designer-based setup with toolbox
• Programmatic creation and initialization
• Adding StatusBarAdvPanel controls
• Basic configuration and docking
• Troubleshooting common setup issues

Panels and Layout

📄 Read: references/panels-and-layout.md

When to read: Managing multiple panels, configuring spacing, customizing panel alignment, or positioning controls.

• StatusBarAdvPanel collection management
• Panel spacing configuration
• CustomLayoutBounds for panel sizing
• Alignment options (Center, Near, Far, ChildConstraints)
• SetHAlign method for horizontal alignment
• Panel positioning and sizing
• Adding child controls to StatusBarAdv
• Layout customization patterns

Appearance and Styling

📄 Read: references/appearance-styling.md

When to read: Customizing status bar appearance, applying gradients, setting colors, or adding sizing grip.

• BackgroundColor property with BrushInfo
• Gradient backgrounds (6 gradient styles)
• Pattern styles and solid colors
• GradientColors array configuration
• MetroColor and UseMetroColorAsBorder
• ForeColor customization
• SizingGrip display
• Complete styling examples

Borders and Themes

📄 Read: references/borders-and-themes.md

When to read: Applying borders, using Office2016 themes, enabling Metro style, or configuring themed backgrounds.

• BorderStyle property (None, FixedSingle, Fixed3D)
• Border3DStyle options (10 styles)
• 2D border configuration (BorderColor, BorderSingle, BorderSides)
• Office2016 themes (Colorful, White, Black, DarkGray)
• Metro style application
• ThemesEnabled and IgnoreThemeBackground
• Complete themed examples

Events and Behavior

📄 Read: references/events-and-behavior.md

When to read: Implementing auto-sizing, handling property change events, or responding to border/gradient changes.

• AutoSize and AutoSizeMode configuration
• AutoHeightControls for panel height
• GetPreferredSize and SetPreferredSize methods
• 9 property change events
• BorderSidesChanged, BorderColorChanged events
• GradientBackgroundChanged event
• ThemeChanged event
• Event handling patterns

Quick Start Example

Basic StatusBarAdv with Panels

C#:

using Syncfusion.Windows.Forms.Tools;
using System.Drawing;
using System.Windows.Forms;

public partial class MainForm : Form
{
    private StatusBarAdv statusBarAdv1;
    private StatusBarAdvPanel culturePanel;
    private StatusBarAdvPanel datePanel;
    private StatusBarAdvPanel timePanel;

    public MainForm()
    {
        InitializeComponent();
        SetupStatusBar();
    }

    private void SetupStatusBar()
    {
        // Create StatusBarAdv
        statusBarAdv1 = new StatusBarAdv
        {
            Dock = DockStyle.Bottom,
            BackColor = Color.LightSteelBlue,
            BorderColor = Color.DarkSlateGray,
            BorderStyle = BorderStyle.FixedSingle,
            SizingGrip = true
        };

        // Create panels
        culturePanel = new StatusBarAdvPanel
        {
            PanelType = StatusBarAdvPanelType.CurrentCulture,
            Size = new Size(120, 27)
        };

        datePanel = new StatusBarAdvPanel
        {
            PanelType = StatusBarAdvPanelType.ShortDate,
            Size = new Size(100, 27)
        };

        timePanel = new StatusBarAdvPanel
        {
            PanelType = StatusBarAdvPanelType.ShortTime,
            Size = new Size(100, 27)
        };

        // Add panels to StatusBarAdv
        statusBarAdv1.Controls.Add(culturePanel);
        statusBarAdv1.Controls.Add(datePanel);
        statusBarAdv1.Controls.Add(timePanel);

        // Add to form
        this.Controls.Add(statusBarAdv1);
    }
}

VB.NET:

Imports Syncfusion.Windows.Forms.Tools
Imports System.Drawing
Imports System.Windows.Forms

Public Partial Class MainForm
    Inherits Form

    Private statusBarAdv1 As StatusBarAdv
    Private culturePanel As StatusBarAdvPanel
    Private datePanel As StatusBarAdvPanel
    Private timePanel As StatusBarAdvPanel

    Public Sub New()
        InitializeComponent()
        SetupStatusBar()
    End Sub

    Private Sub SetupStatusBar()
        ' Create StatusBarAdv
        statusBarAdv1 = New StatusBarAdv With {
            .Dock = DockStyle.Bottom,
            .BackColor = Color.LightSteelBlue,
            .BorderColor = Color.DarkSlateGray,
            .BorderStyle = BorderStyle.FixedSingle,
            .SizingGrip = True
        }

        ' Create panels
        culturePanel = New StatusBarAdvPanel With {
            .PanelType = StatusBarAdvPanelType.CurrentCulture,
            .Size = New Size(120, 27)
        }

        datePanel = New StatusBarAdvPanel With {
            .PanelType = StatusBarAdvPanelType.ShortDate,
            .Size = New Size(100, 27)
        }

        timePanel = New StatusBarAdvPanel With {
            .PanelType = StatusBarAdvPanelType.ShortTime,
            .Size = New Size(100, 27)
        }

        ' Add panels to StatusBarAdv
        statusBarAdv1.Controls.Add(culturePanel)
        statusBarAdv1.Controls.Add(datePanel)
        statusBarAdv1.Controls.Add(timePanel)

        ' Add to form
        Me.Controls.Add(statusBarAdv1)
    End Sub
End Class

Common Patterns

1. Gradient Background with Metro Theme

Apply a modern gradient background with Metro styling:

// Set gradient background (will be overridden if Metro style is applied)
statusBarAdv1.BackgroundColor = new BrushInfo(
    GradientStyle.Horizontal,
    Color.AliceBlue,
    Color.LightSteelBlue
);

// Apply Metro style (this overrides BackgroundColor)
statusBarAdv1.Style = StatusbarStyle.Metro;

// Set metro accent color
statusBarAdv1.MetroColor = ColorTranslator.FromHtml("#16a5dc");
statusBarAdv1.UseMetroColorAsBorder = true;

Note: When Style = StatusbarStyle.Metro is set, any custom BackgroundColor gradients are ignored. Use MetroColor and UseMetroColorAsBorder for Metro styling instead.

2. Custom Panel Alignment

Align panels with custom positioning using ChildConstraints:

// Enable custom alignment
statusBarAdv1.Alignment = FlowAlignment.ChildConstraints;

// Left-align first panel
statusBarAdv1.SetHAlign(panel1, HorzFlowAlign.Left);

// Right-align second panel
statusBarAdv1.SetHAlign(panel2, HorzFlowAlign.Right);

// Justify third panel to fill space
statusBarAdv1.SetHAlign(panel3, HorzFlowAlign.Justify);

3. Office2016 Theme with Auto-Sizing

Apply Office2016 theme with automatic height adjustment:

// Apply Office2016 Colorful theme
statusBarAdv1.Style = StatusbarStyle.Office2016Colorful;

// Enable auto-sizing
statusBarAdv1.AutoSize = true;
statusBarAdv1.AutoSizeMode = AutoSizeMode.GrowAndShrink;

// Auto-adjust panel heights
statusBarAdv1.AutoHeightControls = true;

Key Properties

StatusBarAdv Properties

StatusBarAdvPanel Properties

StatusBarAdv Extender Methods

Common Use Cases

1. Application Status Display: Show ready state, connection status, or operation progress
2. Date/Time Information: Display current date and time using built-in panel types
3. Culture and Localization: Show current culture information with CurrentCulture panel
4. Progress Indicators: Add ProgressBar controls to status bar for long operations
5. Document Information: Display file name, line/column position, or word count
6. Network Status: Show connectivity state or server status with custom panels
7. User Session Info: Display logged-in user name or session details
8. Themed Applications: Apply Office2016 or Metro themes for consistent UI

Additional Resources

• Syncfusion Documentation: StatusBarAdv Official Docs
• Panel Reference: See StatusBarAdvPanel documentation for panel-specific properties
• Theme Support: StatusBarAdv supports VisualStyleManager for application-wide theming

Next Steps

After implementing basic StatusBarAdv:

1. Add Multiple Panels → Read: references/panels-and-layout.md
2. Customize Appearance → Read: references/appearance-styling.md
3. Apply Themes → Read: references/borders-and-themes.md