My.Application.SplashScreen-Eigenschaft

Artikel
08/20/2008

Aktualisiert: November 2007

Ruft den Begrüßungsbildschirm für diese Anwendung ab oder legt diesen fest.

' Usage
Dim value As System.Windows.Forms.Form = My.Application.SplashScreen
' Declaration
Public Property SplashScreen As System.Windows.Forms.Form

Rückgabewert

Ein Form-Objekt, das die Anwendung als Begrüßungsbildschirm verwendet.

Ausnahmen

Die folgende Bedingung kann einen Ausnahmefehler verursachen:

Dieser Eigenschaft und der My.Application.MainForm-Eigenschaft ist derselbe Wert zugewiesen (ArgumentNullException).

Hinweise

Mit der My.Application.SplashScreen-Eigenschaft können Sie das Form-Objekt abrufen oder festlegen, das die Anwendung als Begrüßungsbildschirm verwendet. Hierbei handelt es sich um das erste Grafikformular, das während des Startens der Anwendung angezeigt wird.

Diese Eigenschaft unterstützt das Visual Basic-Anwendungsmodell. Weitere Informationen finden Sie unter Übersicht über das Visual Basic-Anwendungsmodell.

Die Änderungen dieser Eigenschaft werden nicht beibehalten, wenn die Anwendung geschlossen wird. Um den Begrüßungsbildschirm dauerhaft zu ändern, müssen Sie die Einstellung im Projekt-Designer ändern. Weitere Informationen finden Sie unter Gewusst wie: Angeben eines Begrüßungsbildschirms für eine Anwendung (Visual Basic).

Beispiel

In diesem Beispiel werden die My.Application.SplashScreen-Eigenschaft und das My.Application.Startup-Ereignis verwendet, um den Begrüßungsbildschirm beim Starten der Anwendung mit Statusinformationen zu aktualisieren.

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

Dieses Beispiel erfordert, dass das Projekt einen Begrüßungsbildschirm mit dem Namen SplashScreen1 aufweist. Der Begrüßungsbildschirm muss über die Eigenschaft Status verfügen, die die Benutzeroberfläche aktualisiert.

Sie müssen diesen Code im Code-Editor-Fenster für Anwendungsereignisse eingeben. Weitere Informationen finden Sie unter Gewusst wie: Behandeln von Anwendungsereignissen (Visual Basic).

Anforderungen

Namespace: Microsoft.VisualBasic.ApplicationServices

Klasse: WindowsFormsApplicationBase

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Nein
Konsolenanwendung	Nein
Windows-Steuerelementbibliothek	Nein
Web-Steuerelementbibliothek	Nein
Windows-Dienst	Nein
Website	Nein