A newer version of this page is available. Switch to the current version.

Splash Screen Manager Overview

  • 3 minutes to read

The SplashScreenManager component, shipped with the XtraEditors Library, manages the creation and display of splash forms and images. Specific splash forms support the automatic display on your main form's startup, while other splash forms need to be manually displayed and closed. Take note that splash forms are invoked by the Splash Screen Manager in a separate thread.

Splash Forms

The following splash forms are supported.

  • A Splash Screen - is a splash form that can be automatically displayed on your main form's startup. Using a Splash Screen, it is also possible to display a custom image as a splash screen. See Splash Screen and Splash Image to learn more.
  • A Wait Form - is a small form containing an animated image (obtained from the current skin) and two labels, designed to display the progress of any operation. Automatic display of Wait Forms on the main form's startup is not supported. See Wait Form to learn more.
  • An Overlay Form - is a semi-transparent splash screen that runs in a background thread and overlays a control or form to prevent access to it. See Overlay Form to learn more.

These forms can be created at design time. Once a SplashScreenManager component has been added to your main form, use the component's Tasks pane to create a Splash Screen or Wait Form.

SplashScreenManager-Tasks_WhenEmpty

Clicking the Add Splash Screen and/or Add Wait Form links generate splash forms - SplashScreen and WaitForm class descendants. These forms can now be freely customized at design time.

SplashScreenManager-SolutionExplorer-GeneratedSplashForms

The layout of all splash forms can be customized according to your needs. You can change all labels and images, add custom ones, etc.

NOTE

An animated image displayed by Wait Forms is obtained from the current skin. So, to replace the default image, use the WinForms Skin Editor tool.

NOTE

Splash Screens and Wait Forms are generated at design time in separate files (e.g. SplashScreen1.cs, WaitForm1.vb). If you decide to manually add custom classes to these files, please note that the class encapsulating a Splash Screen/Wait Form must be defined first in these files prior to your custom classes.

Displaying Splash Forms

See the Splash Screen, Wait Form, Splash Image and Overlay Form topics to learn how to display corresponding splash forms.

See Also