Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

SplashScreenManager.ShowSkinSplashScreen(String, String, String, String, Form, Boolean, Boolean, Boolean, SplashFormStartPosition, Point) Method

Displays a skin-aware splash screen. The current skin determines the background and font settings of the splash screen’s elements.

Namespace: DevExpress.XtraSplashScreen

Assembly: DevExpress.XtraEditors.v24.2.dll

NuGet Package: DevExpress.Win.Navigation

#Declaration

public static void ShowSkinSplashScreen(
    string title = null,
    string subtitle = null,
    string footer = null,
    string loading = null,
    Form parentForm = null,
    bool useFadeIn = true,
    bool useFadeOut = true,
    bool throwExceptionIfAlreadyOpened = true,
    SplashFormStartPosition startPos = SplashFormStartPosition.Default,
    Point location = default(Point)
)

#Optional Parameters

Name Type Default Description
title String null

A string displayed in the title region. If this parameter is not specified (null), the title region displays the value of the AssemblyTitle attribute (see your project’s AssemblyInfo.cs/AssemblyInfo.vb file).

subtitle String null

A string displayed in the subtitle region. If this parameter is not specified (null), the subtitle region displays the concatenation of the “Version “ string and the value of the AssemblyFileVersion attribute (see your project’s AssemblyInfo.cs/AssemblyInfo.vb file).

footer String null

A string displayed in the footer. If this parameter is not specified (null), the footer displays the concatenation of the AssemblyCopyright attribute value (see your project’s AssemblyInfo.cs/AssemblyInfo.vb file) and the “All Rights Reserved.” string.

loading String null

The text displayed above the progress bar.

parentForm Form null

The splash screen’s owner.

useFadeIn Boolean True

A value that specifies whether to use the fade-in effect when the splash screen is being opened.

useFadeOut Boolean True

A value that specifies whether to use the fade-out effect when the splash screen is being closed.

throwExceptionIfAlreadyOpened Boolean True

true to throw an exception if another splash form has already been opened; false to suppress this exception.

startPos SplashFormStartPosition Default

A value that specifies how the form is positioned.

location Point null

Coordinates at which the splash form is shown (if the startPos parameter is set to Manual).

#Remarks

using DevExpress.XtraSplashScreen;

// Show a splashscreen.
SplashScreenManager.ShowSkinSplashScreen(
    title: "When Only The Best Will Do",
    subtitle: "DevExpress WinForms Controls",
    footer: "Copyright © 2000 - 2020 Developer Express Inc." + Environment.NewLine + "All Rights reserved.",
    loading: "Starting...",
    parentForm: this
);


//Do an operation
//...

//Close the splashscreen
DevExpress.XtraSplashScreen.SplashScreenManager.CloseForm();

The following image demonstrates Skin Splash Screen elements you can customize using method parameters.

image

See Also