Implementing Syncfusion WinForms SplashControl

When to Use This Skill

• Display a splash screen during application startup
• Show branding, logos, or loading information while the app initializes
• Create timed or manually-controlled splash displays
• Implement animated splash screens with visual effects
• Design custom splash panels with controls and content
• Control host form visibility during splash display
• Handle splash screen lifecycle events
• Position splash screens at specific desktop locations

Component Overview

1. Image-based splash screen: Display a static or animated image
2. Custom SplashPanel: Design a fully customizable panel with any controls

• Automatic or manual display control
• Configurable display duration with timer intervals
• Built-in animation effects (left-to-right reveal)
• Flexible desktop positioning (center, corners, system tray, custom)
• Host form visibility management
• Modal or non-modal display modes
• Transparency support
• Complete event lifecycle

Documentation and Navigation Guide

Getting Started

• Assembly references and NuGet packages
• Adding SplashControl through designer or code
• Basic property configuration
• AutoMode vs manual invocation
• Running your first splash screen

Display and Timing Configuration

• AutoMode for automatic display on form load
• AutoModeDisableOwner for modal splash screens
• ShowSplash() method for manual display control
• HideSplash() to close programmatically
• ShowDialogSplash() for modal dialog display
• TimerInterval to control display duration
• IsShowing property to check display state

Image and Animation Settings

• Setting the SplashImage property
• Enabling animation with ShowAnimation
• Configuring transparent colors
• ShowAsTopMost to control window layering
• Animation behavior and effects

Alignment and Positioning

• DesktopAlignment options (Center, SystemTray, corners)
• Custom positioning strategies
• Visual examples for each alignment mode

Host Form Management

• HostForm property configuration
• HideHostForm to conceal the main form
• HostFormWindowState for controlling form state (Normal, Minimized, Maximized)
• Coordination between splash and host form

Custom SplashPanel Integration

• Using SplashPanel instead of static images
• CustomSplashPanel property
• UseCustomSplashPanel to enable custom panels
• Designing panels with controls (labels, progress bars, etc.)
• SplashControlPanel property
• ShowInTaskbar and FormIcon configuration
• Complete integration workflow with code examples

Event Handling

• BeforeSplash event (with cancellation support)
• SplashDisplayed event
• SplashClosing event
• SplashClosed event
• Event notification methods
• Logging and debugging patterns

Quick Start

Basic Image-Based Splash Screen

using Syncfusion.Windows.Forms.Tools;

public partial class Form1 : Form
{
    private SplashControl splashControl1;

    public Form1()
    {
        InitializeComponent();
        
        // Initialize SplashControl
        this.splashControl1 = new SplashControl();
        
        // Set the splash image
        this.splashControl1.SplashImage = Image.FromFile("splash.png");
        
        // Configure basic properties
        this.splashControl1.HostForm = this;
        this.splashControl1.TimerInterval = 3000; // Display for 3 seconds
        this.splashControl1.AutoMode = true; // Auto-display on form load
        this.splashControl1.DesktopAlignment = SplashAlignment.Center;
        
        // Optional: Enable animation
        this.splashControl1.ShowAnimation = true;
    }
}

Manual Display Control

// Display splash screen manually
private void ShowSplashButton_Click(object sender, EventArgs e)
{
    // Show splash and disable owner form
    splashControl1.ShowSplash(true);
}

// Hide splash screen programmatically
private void HideSplashButton_Click(object sender, EventArgs e)
{
    splashControl1.HideSplash();
}

// Show as modal dialog
private void ShowModalSplash_Click(object sender, EventArgs e)
{
    splashControl1.ShowDialogSplash(this);
}

Common Patterns

Automatic Splash with Hidden Host Form

private void InitializeSplash()
{
    splashControl1.HostForm = this;
    splashControl1.SplashImage = Properties.Resources.CompanyLogo;
    splashControl1.AutoMode = true;
    splashControl1.HideHostForm = true;
    splashControl1.TimerInterval = 4000;
    splashControl1.DesktopAlignment = SplashAlignment.Center;
    
    // Handle splash closed event to perform initialization
    splashControl1.SplashClosed += (s, e) => 
    {
        // Perform app initialization after splash closes
        LoadApplicationData();
    };
}

Custom SplashPanel with Progress

private void SetupCustomSplashPanel()
{
    // Create and design SplashPanel
    SplashPanel splashPanel = new SplashPanel();
    splashPanel.BackgroundColor = new BrushInfo(GradientStyle.Vertical, 
        Color.White, Color.LightBlue);
    splashPanel.Size = new Size(400, 200);
    
    // Add label
    Label statusLabel = new Label
    {
        Text = "Loading Application...",
        AutoSize = true,
        Location = new Point(50, 80),
        Font = new Font("Segoe UI", 14, FontStyle.Bold)
    };
    splashPanel.Controls.Add(statusLabel);
    
    // Configure SplashControl to use custom panel
    splashControl1.CustomSplashPanel = splashPanel;
    splashControl1.UseCustomSplashPanel = true;
    splashControl1.HostForm = this;
    splashControl1.TimerInterval = 5000;
}

Event-Driven Splash Display

private void ConfigureSplashEvents()
{
    splashControl1.BeforeSplash += (s, e) =>
    {
        // Log before display
        Debug.WriteLine("Splash screen about to display");
        
        // Cancel if needed
        // e.Cancel = true;
    };
    
    splashControl1.SplashDisplayed += (s, e) =>
    {
        Debug.WriteLine("Splash screen is now visible");
        StartBackgroundInitialization();
    };
    
    splashControl1.SplashClosing += (s, e) =>
    {
        Debug.WriteLine("Splash screen is closing");
    };
    
    splashControl1.SplashClosed += (s, e) =>
    {
        Debug.WriteLine("Splash screen closed");
        ShowMainForm();
    };
}

Transparent Splash Screen

private void ConfigureTransparentSplash()
{
    splashControl1.SplashImage = Properties.Resources.LogoWithTransparency;
    splashControl1.TransparentColor = Color.White; // Make white pixels transparent
    splashControl1.ShowAnimation = true;
    splashControl1.ShowAsTopMost = true;
    splashControl1.DesktopAlignment = SplashAlignment.Center;
    splashControl1.TimerInterval = 3000;
}

Key Properties

Key Methods

Key Events

Common Use Cases

Application Startup Branding

Long Initialization Process

Version Update Notification

Professional User Experience

Timed Information Display

Related Components

• SplashPanel: Standalone splash panel that can be used independently or integrated with SplashControl
• SplashScreen: Alternative splash screen implementation approaches in WinForms

Tips and Best Practices

1. Keep splash duration reasonable: 2-5 seconds is ideal; longer durations frustrate users
2. Match application theme: Ensure splash screen design aligns with your application's visual identity
3. Use AutoMode for simplicity: Unless you need complex control, AutoMode handles most scenarios
4. Handle SplashClosed event: Perform initialization tasks when splash closes to ensure smooth transition
5. Consider SplashPanel for dynamic content: Use custom panels when you need progress bars or changing text
6. Test different alignments: Center usually works best, but SystemTray can be less intrusive
7. Use HideHostForm judiciously: Hiding the host form can create a cleaner startup experience
8. Enable animation selectively: Animation adds polish but may not suit all application types

Assembly Dependencies

• Syncfusion.Shared.Base.dll

• Syncfusion.Tools.Windows.dll

Install-Package Syncfusion.Tools.Windows