WindowsFormsApplicationBase.SplashScreen Eigenschaft

Definition

Ruft Begrüßungsbildschirm dieser Anwendung ab oder legt diesen fest.Gets or sets the splash screen for this application.

public:
 property System::Windows::Forms::Form ^ SplashScreen { System::Windows::Forms::Form ^ get(); void set(System::Windows::Forms::Form ^ value); };
public System.Windows.Forms.Form SplashScreen { get; set; }
member this.SplashScreen : System.Windows.Forms.Form with get, set
Public Property SplashScreen As Form

Eigenschaftswert

Form

Der Begrüßungsbildschirm für die Anwendung.The splash screen for the application.

Ausnahmen

Dieser Eigenschaft und der MainForm-Eigenschaft ist derselbe Wert zugewiesen.The same value is assigned to this property and the MainForm property.

Beispiele

In diesem Beispiel werden die My.Application.SplashScreen -Eigenschaft und das- My.Application.Startup Ereignis verwendet, um den Begrüßungsbildschirm mit Statusinformationen zu aktualisieren, wenn die Anwendung gestartet wird.This example uses the My.Application.SplashScreen property and the My.Application.Startup event to update the splash screen with status information as the application starts.

Private Sub MyApplication_Startup(
    sender As Object,
    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

Für dieses Beispiel ist es erforderlich, dass das Projekt einen Begrüßungsbildschirm mit dem Namen hat SplashScreen1 .This example requires that the project have a splash screen named SplashScreen1. Der Begrüßungsbildschirm muss über eine Eigenschaft mit dem Namen verfügen Status , die seine Benutzeroberfläche aktualisiert.The splash screen needs to have a property named Status that updates its user interface.

Sie müssen diesen Code im Code-Editor-Fenster für Anwendungs Ereignisse eingeben.You must enter this code in the Code Editor window for application events. Weitere Informationen finden Sie unter Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Hinweise

Mit der- My.Application.SplashScreen Eigenschaft können Sie das-Objekt, das Form die Anwendung verwendet, als Begrüßungsbildschirm festlegen, das erste Grafik Formular, das angezeigt wird, während eine Anwendung gestartet wird.The My.Application.SplashScreen property allows you to get or set the Form object that the application uses as the splash screen, the first graphic form that is displayed while an application is being started.

Diese Eigenschaft unterstützt das Visual Basic Anwendungsmodell.This property supports the Visual Basic Application model. Weitere Informationen finden Sie unter Übersicht über das Visual Basic-Anwendungsmodell.For more information, see Overview of the Visual Basic Application Model.

Die Änderungen an dieser Eigenschaft werden nicht persistent gespeichert, wenn die Anwendung geschlossen wird.The changes to this property are not persisted when the application closes. Um den Begrüßungsbildschirm dauerhaft zu ändern, müssen Sie die Einstellung im Projekt-Designerändern.To change the splash screen permanently, you must change the setting in the Project Designer.

Verfügbarkeit nach ProjekttypAvailability by Project Type

ProjekttypProject type VerfügbarAvailable
Windows Forms-AnwendungWindows Forms Application JaYes
KlassenbibliothekClass Library NeinNo
KonsolenanwendungConsole Application NeinNo
Windows Forms-SteuerelementbibliothekWindows Forms Control Library NeinNo
WebsteuerelementbibliothekWeb Control Library NeinNo
Windows-DienstWindows Service NeinNo
WebsiteWeb Site NeinNo

Gilt für:

Siehe auch