[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Collapse]Forms and User Controls
    Ribbon Form
    Tabbed Form
    Fluent Design Form
    Form Assistant
    Taskbar Assistant
   [Collapse]Splash Screen Manager
     Splash Screen Manager Overview
     Splash Screen
     Splash Image
     Wait Form
     Splash Form Position
     Splash Screen Manager Serialization Specifics
     Overlay Form
   [Expand]Adorner UI Manager
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[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
[Expand]eXpressApp Framework
[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 Image

This topic covers information on displaying custom images as splash screens using the Splash Screen Manager component. Image transparency is supported, so splash images may be of an irregular form and may contain shadows.

There are two ways to display an image as a splash screen.

Expanded Method 1 - Create a Splash Image Using a Splash Screen

The first method is described in the Splash Screen document. Create a SplashScreen object via the Splash Screen Manager component and set the SplashScreen.ShowMode property to Image. Then, specify a custom splash image using the SplashScreen.SplashImageOptions property. Below you can see the default splash image displayed if no custom image is specified.

Using this method, you can choose between displaying a Splash Screen with an image automatically on the main form's startup or manually during the application run. See Splash Screen to learn more.

Expanded Method 2 - Direct Image Display

Another way to show an image as a splash screen is to manually call the static SplashScreenManager.ShowImage method. An image to be displayed is passed as the method's parameter. To hide the image, call SplashScreenManager.HideImage.

Note that the SplashScreenManager.ShowImage method has a number of overloads that allow fade-in and fade-out effects to be enabled and draw custom graphics over the image.

Unlike the first approach, this one doesn't allow custom controls to be added above the splash image. However, you can draw custom graphics over the image by using the ShowImage method overload that takes an ICustomImagePainter object as a parameter. You need to create a class supporting the ICustomImagePainter interface and implement a paint procedure via the ICustomImagePainter.Draw method. The ICustomImagePainter.Draw method will be invoked each time the splash image is redisplayed. If required, you can dynamically update the splash image by calling the SplashScreenManager.Invalidate method, thus forcing your ICustomImagePainter.Draw method to be re-called.

Expanded Example

In this example, an image is displayed as a splash screen via the SplashScreenManager.ShowImage method.Custom information is painted over this image via a custom class (SplashImagePainter), whose instance is passed as a parameter to the ShowImage method. The SplashImagePainter draws text labels with custom progress information.

Expanded See Also

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