My.Application.SplashScreen, propriété
Mise à jour : novembre 2007
Obtient ou définit l'écran de démarrage pour cette application.
' Usage
Dim value As System.Windows.Forms.Form = My.Application.SplashScreen
' Declaration
Public Property SplashScreen As System.Windows.Forms.Form
Valeur de retour
Objet Form que l'application utilise comme écran de démarrage.
Exceptions
La condition ci-dessous peut générer une exception :
- La même valeur est assignée à cette propriété et à la propriété My.Application.MainForm (ArgumentNullException).
Notes
La propriété My.Application.SplashScreen vous permet d'obtenir ou de définir l'objet Form que l'application utilise comme écran de démarrage, c'est-à-dire le premier formulaire graphique qui s'affiche au démarrage d'une application.
Cette propriété prend en charge le modèle d'application Visual Basic. Pour plus d'informations, consultez Vue d'ensemble du modèle d'application Visual Basic.
Les modifications apportées à cette propriété ne sont pas rendues persistantes lors de la fermeture de l'application. Pour changer l'écran de démarrage de manière permanente, vous devez modifier le paramètre dans le Concepteur de projets. Pour plus d'informations, consultez Comment : spécifier un écran de démarrage pour une application (Visual Basic).
Exemple
Cet exemple utilise la propriété My.Application.SplashScreen et l'événement My.Application.Startup pour mettre à jour l'écran de démarrage à l'aide des informations d'état au démarrage de l'application.
Private Sub MyApplication_Startup( _
ByVal sender As Object, _
ByVal e As Microsoft.VisualBasic.ApplicationServices.StartupEventArgs _
) Handles Me.Startup
' Get the splash screen.
Dim splash As SplashScreen1 = CType(My.Application.SplashScreen, SplashScreen1)
' Display current status information.
splash.Status = "Current user: " & My.User.Name
End Sub
Cet exemple requiert que le projet possède un écran de démarrage nommé SplashScreen1. L'écran de démarrage doit contenir une propriété nommée Status qui met à jour son interface utilisateur.
Vous devez entrer ce code dans la fenêtre de l'éditeur de code pour les événements d'application. Pour plus d'informations, consultez Comment : gérer les événements d'application (Visual Basic).
Configuration requise
Espace de noms :Microsoft.VisualBasic.ApplicationServices
Classe :WindowsFormsApplicationBase
Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)
Disponibilité par type de projet
Type de projet |
Disponible |
|---|---|
Application Windows |
Oui |
Bibliothèque de classes |
Non |
Application console |
Non |
Bibliothèque de contrôles Windows |
Non |
Bibliothèque de contrôles Web |
Non |
Service Windows |
Non |
Site Web |
Non |
Autorisations
Aucune autorisation n'est requise.