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.v20.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

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)
)

VB.NET

Public Shared Sub ShowFluentSplashScreen(
    title As String = Nothing,
    subtitle As String = Nothing,
    leftFooter As String = Nothing,
    rightFooter As String = Nothing,
    opacity As Integer = 50,
    opacityColor As Color = Nothing,
    loadingIndicatorType As FluentLoadingIndicatorType = FluentLoadingIndicatorType.Dots,
    logoImageOptions As ImageOptions = Nothing,
    customDrawEventHandler As EventHandler(Of FluentSplashScreenCustomDrawEventArgs) = Nothing,
    parentForm As Form = Nothing,
    useFadeIn As Boolean = False,
    useFadeOut As Boolean = False,
    throwExceptionIfAlreadyOpened As Boolean = True,
    startPos As SplashFormStartPosition = SplashFormStartPosition.Default,
    location As Point = Nothing
)

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	3	The loading indicator kind to use.
logoImageOptions	DevExpress.Utils.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	0	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

C#

// 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();

VB.NET

' Logo image
Dim myLogoImageOptions As ImageOptions = New ImageOptions()
myLogoImageOptions.SvgImage = My.Resources.Logo

' Show a splashscreen.
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:=Me
)

'Do an operation
'...

'Close the splashscreen
DevExpress.XtraSplashScreen.SplashScreenManager.CloseForm()

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

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.