Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Collapse]Forms and User Controls
    XtraForm
    Ribbon Form
    Tabbed Form
    XtraUserControl
    Form Assistant
    Taskbar Assistant
   [Collapse]Splash Screen Manager
    [Expand]Examples
     Splash Screen Manager Overview
     Splash Screen
     Splash Image
     Wait Form
     Splash Form Position
     Splash Screen Manager Serialization Specifics
   [Expand]Adorner UI Manager
   [Expand]Examples
  [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]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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, assign a custom splash image to the SplashScreen.SplashImage 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

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E3719.

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

How would you rate this topic?​​​​​​​