Implementing Status Bar Panels (StatusBarAdvPanel)

When to Use This Skill

• Create individual status bar panels with custom content and styling
• Display key state indicators (NumLock, CapsLock, ScrollLock, Insert key)
• Show date/time information in various formats (short date, long date, short time, long time)
• Display culture information (CurrentCulture) in status bars
• Implement marquee text animation with scrolling, sliding, or alternating effects
• Apply gradient backgrounds or patterns to status bar panels
• Configure panel alignment within StatusBarAdv or flow layouts
• Add custom borders (2D or 3D) to individual panels
• Handle property change events for dynamic panel updates
• Create themed status bar panels matching application design

Component Overview

• Panel Types: Predefined types for key states, date/time, culture, or custom text
• Marquee Animation: Scrolling text with customizable speed, direction, and style
• Enhanced Backgrounds: Gradient, pattern, and solid color options using BrushInfo
• Icon Support: Display icons alongside panel text
• Alignment Options: Content alignment (Left, Right, Center) and flow alignment (including Justify)
• Border Customization: 2D and 3D border styles with custom colors
• Auto-Sizing: Automatic resizing based on content (SizeToContent)
• Theme Support: ThemesEnabled and IgnoreThemeBackground properties
• ToolTip Support: Add tooltips to provide additional information
• 18 Property Events: Comprehensive event handling for property changes

Syncfusion.Windows.Forms.Tools

Documentation and Navigation Guide

Getting Started

• Assembly requirements and installation
• Designer-based setup with drag-and-drop
• Programmatic creation and initialization
• Adding panels to StatusBarAdv or forms
• Basic configuration (Location, Size, BackgroundColor)
• PanelType and BorderColor setup
• Troubleshooting common setup issues

Panel Types and Behavior

• PanelType property options (key states, date/time, culture, custom)
• Key state indicators (NumLock, CapsLock, ScrollLock, InsertKey)
• Date/time formats (ShortDate, LongDate, ShortTime, LongTime)
• Custom text panels with Text property
• GetText() method for key state text retrieval
• SizeToContent for automatic panel resizing
• PreferredSize property configuration

Appearance and Styling

• BackgroundColor property with BrushInfo
• Gradient styles (6 types: ForwardDiagonal, BackwardDiagonal, Horizontal, Vertical, PathRectangle, PathEllipse)
• Pattern styles (Cross, DiagonalCross, DottedGrid, LargeGrid, Wave)
• GradientBackground and GradientColors configuration
• BackColor and ForeColor customization
• Icon property for panel icons
• Complete styling examples

Text and Marquee Animation

• Text property configuration
• IsMarquee property for enabling animation
• AnimationDelay for timing control
• AnimationDirection (Left/Right)
• AnimationSpeed customization
• AnimationStyle (Scroll, Slide, Alternate)
• StartAnimation() and StopAnimation() methods
• Complete marquee examples

Alignment and Borders

• Alignment property (Left, Right, Center)
• HAlign property for flow layout (Left, Right, Center, Justify)
• BorderStyle property (None, FixedSingle, Fixed3D)
• Border3DStyle options (10 styles)
• BorderColor for 2D borders
• BorderSingle styles (Solid, Dashed, Dotted, Inset, Outset, None)
• BorderSides configuration (Left, Top, Right, Bottom, Middle, All)
• 2D vs 3D border examples

Themes, ToolTips, and Events

• ThemesEnabled property
• IgnoreThemeBackground property
• ToolTip property configuration
• 18 property change events
• Event subscription examples
• Event handling patterns
• Complete event monitoring example

Quick Start Example

Basic StatusBarAdvPanel with Gradient Background

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

public partial class MainForm : Form
{
    private StatusBarAdvPanel statusBarAdvPanel1;
    
    public MainForm()
    {
        InitializeComponent();
        SetupStatusBarPanel();
    }
    
    private void SetupStatusBarPanel()
    {
        // Create StatusBarAdvPanel
        statusBarAdvPanel1 = new StatusBarAdvPanel
        {
            // Set panel location and size
            Location = new Point(160, 184),
            Size = new Size(216, 48),
            
            // Configure panel type to show long date
            PanelType = StatusBarAdvPanelType.LongDate,
            
            // Apply gradient background
            BackgroundColor = new BrushInfo(
                GradientStyle.BackwardDiagonal, 
                Color.PaleVioletRed, 
                Color.PeachPuff
            ),
            
            // Set border and alignment
            BorderColor = Color.Black,
            HAlign = HorzFlowAlign.Left
        };
        
        // Add to form
        this.Controls.Add(statusBarAdvPanel1);
    }
}

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

Public Partial Class MainForm
    Inherits Form
    
    Private statusBarAdvPanel1 As StatusBarAdvPanel
    
    Public Sub New()
        InitializeComponent()
        SetupStatusBarPanel()
    End Sub
    
    Private Sub SetupStatusBarPanel()
        ' Create StatusBarAdvPanel
        statusBarAdvPanel1 = New StatusBarAdvPanel With {
            .Location = New Point(160, 184),
            .Size = New Size(216, 48),
            .PanelType = StatusBarAdvPanelType.LongDate,
            .BackgroundColor = New BrushInfo(
                GradientStyle.BackwardDiagonal, 
                Color.PaleVioletRed, 
                Color.PeachPuff
            ),
            .BorderColor = Color.Black,
            .HAlign = HorzFlowAlign.Left
        }
        
        ' Add to form
        Me.Controls.Add(statusBarAdvPanel1)
    End Sub
End Class

Common Patterns

Pattern 1: Marquee Panel with Scrolling Text

// Configure marquee panel
var marqueePanel = new StatusBarAdvPanel
{
    Text = "Welcome to our application! Latest updates available...",
    IsMarquee = true,
    AnimationStyle = MarqueeStyle.Scroll,
    AnimationDirection = MarqueeDirection.Left,
    AnimationSpeed = 5,
    AnimationDelay = 10,
    Size = new Size(300, 30),
    BackColor = Color.LightBlue
};

// Start animation on form load
marqueePanel.StartAnimation();

// Stop animation when needed
// marqueePanel.StopAnimation();

Pattern 2: Key State Indicator Panels

// NumLock indicator
var numLockPanel = new StatusBarAdvPanel
{
    PanelType = StatusBarAdvPanelType.NumLockState,
    Size = new Size(80, 24),
    HAlign = HorzFlowAlign.Right,
    BackgroundColor = new BrushInfo(Color.WhiteSmoke)
};

// CapsLock indicator
var capsLockPanel = new StatusBarAdvPanel
{
    PanelType = StatusBarAdvPanelType.CapsLockState,
    Size = new Size(80, 24),
    HAlign = HorzFlowAlign.Right,
    BackgroundColor = new BrushInfo(Color.WhiteSmoke)
};

// InsertKey indicator
var insertKeyPanel = new StatusBarAdvPanel
{
    PanelType = StatusBarAdvPanelType.InsertKeyState,
    Size = new Size(80, 24),
    HAlign = HorzFlowAlign.Right,
    BackgroundColor = new BrushInfo(Color.WhiteSmoke)
};

Pattern 3: Custom Border with 3D Effect

// Create panel with 3D raised border
var borderedPanel = new StatusBarAdvPanel
{
    Text = "Status: Ready",
    Size = new Size(150, 30),
    BorderStyle = BorderStyle.Fixed3D,
    Border3DStyle = Border3DStyle.RaisedInner,
    BorderSides = Border3DSide.All,
    Alignment = HorizontalAlignment.Center,
    BackgroundColor = new BrushInfo(
        GradientStyle.Horizontal,
        Color.LavenderBlush,
        Color.RosyBrown
    )
};

Key Properties

StatusBarAdvPanel Properties

Common Use Cases

1. Application Status Display: Show current application state with custom text and styling
2. Keyboard State Indicators: Display NumLock, CapsLock, ScrollLock, and Insert key states
3. Date/Time Information: Show current date and time in various formats
4. Culture Information: Display current culture settings
5. Marquee Announcements: Scrolling text for announcements or updates
6. Progress Indicators: Custom panels with text indicating processing status
7. Document Information: Show document-related information (line number, position, etc.)
8. Themed Status Panels: Match application theme with coordinated panel styling

Additional Resources

• Use within StatusBarAdv control for enhanced status bars
• Combine multiple panels with different types for comprehensive status displays
• Leverage events for dynamic panel updates based on application state
• Apply consistent theming across all panels for professional appearance

• Implementing Status Bars (StatusBarAdv) - Parent control for hosting panels