[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Collapse]eXpressApp Framework
 [Expand]Getting Started
  [Expand]Application Solution Components
  [Expand]Business Model Design
  [Expand]Application Model
  [Collapse]UI Construction
    UI Element Overview
    Windows and Frames
    Action Containers
   [Expand]View Items
    List Editors
    Ways to Access UI Elements and Their Controls
    Add and Override Images
    Text Notifications
    Ways to Show a Confirmation Dialog
    ASP.NET Web Application Appearance
    Ways to Customize a Mobile Application
    Application Personalization
    Using a Custom Control that is not Integrated by Default
    XAF Mobile Wrappers for DevExtreme Widgets
   [Collapse]Splash Forms
     Manage Splash Forms in an Application
     Customize Built-In Splash Forms
     Create and Show a Splash Form
     Use a Custom Class to Show a Splash Form
     Localize a Splash Form
  [Expand]Controllers and Actions
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Expand]System Module
  [Expand]Extra Modules
  [Expand]Debugging, Testing and Error Handling
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Task-Based Help
  Frequently Asked Questions (FAQ)
 [Expand]API Reference
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Splash Forms

This article provides a general overview of splash forms. It shows splash forms available in XAF, describes how they are initialized, and provides information on how to customize them.

Splash forms are forms XAF WinForms applications show automatically at the application's startup and when users log in. You can also show splash forms when the application retrieves or saves data or for other operations that may run long - to indicate progress.

The following splash forms are available:

Splash Form Name Default Use Scenarios Possible Use Scenarios Splash Form Appearance
A Splash Screen At the application's startup To indicate progress when the application retrieves data or when an application exits and saves all related data.
An Overlay Form When you log in To indicate progress and disable the current window while the application accesses data.
A Wait Form Not shown At the application's startup or to indicate progress when the application loads data.
A Splash Image Not shown To show an image that indicates progress on an application's startup or when an application works with the database.

XAF uses a DXSplashScreen instance and the WinForms Splash Screen Manager to show, update, and close splash forms. If you need to access additional methods, use the SplashScreenManager component directly.

Expanded Splash Form Initialization

When you create a new XAF WinForms Application, the Solution Wizard sets the WinApplication.SplashScreen property value to a new DXSplashScreen instance. The Solution Wizard uses the DXSplashScreen.DXSplashScreen constructor.

You can find this code in the WinForms Application project's WinApplication.cs (WinApplication.vb) file.

The Solution Wizard sets the ExecuteStartupLogicBeforeClosingLogonWindow property to true in all new XAF applications. This setting keeps the Logon Window and the Overlay Form open until the Main Window loads and while all Startup Actions (see ModuleBase.GetStartupActions) are executed.

All new XAF WinForms applications show the default Splash Screen and Overlay Form.

You can customize splash forms in your application.

Expanded Splash Form Customization

Is this topic helpful?​​​​​​​