My.Application.MinimumSplashScreenDisplayTime Property

Switch View

MinimumSplashScreenDisplayTime Prop...

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

Visual Basic Language Reference

My.Application.MinimumSplashScreenDisplayTime Property

Determines the minimum length of time, in milliseconds, for which the splash screen is displayed.

' Usage
Dim value As Integer = My.Application.MinimumSplashScreenDisplayTime
' Declaration
Public Property MinimumSplashScreenDisplayTime As Integer

Return Value

Integer. The minimum length of time, in milliseconds, for which the splash screen is displayed.

Remarks

The My.Application.MinimumSplashScreenDisplayTime property allows you to specify the minimum length of time you want the application's splash screen to be displayed. If the main form finishes initializing in less time than what is specified by this property, the splash screen remains until the requested amount of time passes, at which time the main form is displayed. If your application takes longer to start, the splash screen is closed once the main form becomes active.

When you add a splash screen to your application using the Project Designer, it sets the My.Application.MinimumSplashScreenDisplayTime property to 2000, giving a minimum display time of two seconds.

This property supports the Visual Basic Application model. For more information, see Overview of the Visual Basic Application Model.

You should set the My.Application.MinimumSplashScreenDisplayTime property in a method that overrides the OnInitialize or OnCreateSplashScreen method. Code that overrides methods of the WindowsFormsApplicationBase class should be entered in the ApplicationEvents.vb file, which is hidden by default.

To access the Code Editor window for overriding members

With a project selected in Solution Explorer, click Properties on the Project menu.
Click the Application tab.
Click the View Application Events button to open the Code Editor.

For more information, see How to: Handle Application Events (Visual Basic).

Example

This example demonstrates how to set the My.Application.MinimumSplashScreenDisplayTime property by overriding the OnInitialize property.

Visual Basic

Protected Overrides Function OnInitialize( _
    ByVal commandLineArgs As _
    System.Collections.ObjectModel.ReadOnlyCollection(Of String) _
) As Boolean
    ' Set the display time to 5000 milliseconds (5 seconds). 
    Me.MinimumSplashScreenDisplayTime = 5000
    Return MyBase.OnInitialize(commandLineArgs)
End Function

This example requires that the project have a splash screen.

You must enter this code in the Code Editor window for application events. For more information, see How to: Handle Application Events (Visual Basic).

Permissions

No permissions are required.

Requirements

Namespace: Microsoft.VisualBasic.ApplicationServices

Class: WindowsFormsApplicationBase

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Availability by Project Type

Project type	Available
Windows Application	Yes
Class Library	No
Console Application	No
Windows Control Library	No
Web Control Library	No
Windows Service	No
Web Site	No

Reference

My.Application Object
My.Application.SplashScreen Property
Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase.MinimumSplashScreenDisplayTime
OnInitialize
OnCreateSplashScreen
WindowsFormsApplicationBase

Concepts

Extending the Visual Basic Application Model