SplashScreenManager.ShowForm(Form, Type, Boolean, Boolean, Boolean) Method

Creates and displays the specified SplashScreen or WaitForm descendant, centering it against another form.

The method’s parameter allows you to suppress an exception that is thrown if another splash form has already been opened.

Namespace: DevExpress.XtraSplashScreen

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

C#

public static void ShowForm(
    Form parentForm,
    Type splashFormType,
    bool useFadeIn,
    bool useFadeOut,
    bool throwExceptionIfAlreadyOpened
)

VB.NET

Public Shared Sub ShowForm(
    parentForm As Form,
    splashFormType As Type,
    useFadeIn As Boolean,
    useFadeOut As Boolean,
    throwExceptionIfAlreadyOpened As Boolean
)

Parameters

Name	Type	Description
parentForm	Form	A Form relative to which the displayed splash form is positioned. This parameter is in effect when displaying WaitForms.
splashFormType	Type	The type of splash form to be displayed.
useFadeIn	Boolean	true to use the fade-in effect when opening the form; otherwise, false.
useFadeOut	Boolean	true to use the fade-out effect when closing the form; otherwise, false.
throwExceptionIfAlreadyOpened	Boolean	true to throw an exception if another splash form has already been opened; false to suppress this exception.

Remarks

Only one splash form can be opened simultaneously. If you call the ShowForm method while another splash form is being displayed, an exception will be thrown if the throwExceptionIfAlreadyOpened parameter is set to true. To suppress this exception, set this parameter to false.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ShowForm(Form, Type, Boolean, Boolean, Boolean) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-splash-screen-loading-panel/CS/Form1.cs#L20

//Open Wait Form
SplashScreenManager.ShowForm(this, typeof(WaitForm1), true, true, false);
try {

how-to-dynamically-change-a-wait-forms-labels-e3575/CS/Form1.cs#L20

//Open Wait Form
SplashScreenManager.ShowForm(this, typeof(WaitForm1), true, true, false);

how-to-interact-with-a-splash-screen-by-sending-commands-e3576/CS/Form1.cs#L21

// Open a Splash Screen
SplashScreenManager.ShowForm(this, typeof(SplashScreen1), true, true, false);

VB.NET

winforms-splash-screen-loading-panel/VB/Form1.vb#L22

'Open Wait Form
SplashScreenManager.ShowForm(Me, GetType(WaitForm1), True, True, False)
Try

how-to-dynamically-change-a-wait-forms-labels-e3575/VB/Form1.vb#L22

'Open Wait Form
SplashScreenManager.ShowForm(Me, GetType(WaitForm1), True, True, False)

how-to-interact-with-a-splash-screen-by-sending-commands-e3576/VB/Form1.vb#L19

' Open a Splash Screen
SplashScreenManager.ShowForm(Me, GetType(SplashScreen1), True, True, False)
' The splash screen will be opened in a separate thread. To interact with it, use the SendCommand method.