Skip to main content

SplashScreenManager.ShowFluentSplashScreen(String, String, String, String, Int32, Color, FluentLoadingIndicatorType, ImageOptions, EventHandler<FluentSplashScreenCustomDrawEventArgs>, Form, Boolean, Boolean, Boolean, SplashFormStartPosition, Point) Method

Displays a Windows 10-inspired splash screen (features an Acrylic material effect - a partially transparent texture).

Namespace: DevExpress.XtraSplashScreen

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

public static void ShowFluentSplashScreen(
    string title = null,
    string subtitle = null,
    string leftFooter = null,
    string rightFooter = null,
    int opacity = 50,
    Color opacityColor = default(Color),
    FluentLoadingIndicatorType loadingIndicatorType = FluentLoadingIndicatorType.Dots,
    ImageOptions logoImageOptions = null,
    EventHandler<FluentSplashScreenCustomDrawEventArgs> customDrawEventHandler = null,
    Form parentForm = null,
    bool useFadeIn = false,
    bool useFadeOut = false,
    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 value of the AssemblyCompany attribute (see your project’s AssemblyInfo.cs/AssemblyInfo.vb file).

leftFooter String null

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

rightFooter String null

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

opacity Int32 50

The opacity level for the splashscreen’s background. This setting is supported if the application runs under Windows 10 Version 1803 (OS build 17134) or newer. On older Windows versions, the splashscreen fills its background with a non-trasparent color (the ‘opacityColor’ parameter).

opacityColor Color null

The background color. If the opacityColor parameter is set to Color.Empty, the actual background color is Color.Black.

loadingIndicatorType DevExpress.XtraSplashScreen.FluentLoadingIndicatorType Dots

The loading indicator kind to use.

logoImageOptions ImageOptions null

The object to specify the logo image and its settings.

customDrawEventHandler EventHandler<DevExpress.XtraSplashScreen.FluentSplashScreenCustomDrawEventArgs> null

The event handler to perform custom painting.

parentForm Form null

The splash screen’s owner.

useFadeIn Boolean False

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

useFadeOut Boolean False

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

// Show a splashscreen.
ImageOptions myLogoImageOptions = new ImageOptions();
myLogoImageOptions.SvgImage = Resources.Logo;

DevExpress.XtraSplashScreen.SplashScreenManager.ShowFluentSplashScreen(
    logoImageOptions: myLogoImageOptions,
    title: "When Only The Best Will Do",
    subtitle: "DevExpress WinForms Controls",
    rightFooter: "Starting...",
    leftFooter: "Copyright © 2000 - 2020 Developer Express Inc." + Environment.NewLine + "All Rights reserved.",
    loadingIndicatorType: FluentLoadingIndicatorType.Dots,
    opacity: 130,
    parentForm: this
);

//Do an operation
//...

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

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

image

To customize the appearance settings (font, color, word wrap options, etc.) used to paint the title, subtitle, left footer and right footer, use the ShowFluentSplashScreen method overload with a FluentSplashScreenOptions parameter. The FluentSplashScreenOptions class provides properties to adjust these appearance settings.

See Also