Proprietà My.Application.SplashScreen

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ottiene o imposta la schermata iniziale per l'applicazione.

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

Valore restituito

Oggetto Form utilizzato dall'applicazione come schermata iniziale.

Eccezioni

La seguente condizione può causare un'eccezione:

A questa proprietà e alla proprietà My.Application.MainForm (ArgumentNullException) è stato assegnato lo stesso valore.

Note

La proprietà My.Application.SplashScreen consente di ottenere o impostare l'oggetto Form utilizzato dall'applicazione come schermata iniziale, ossia come primo form grafico visualizzato durante l'avvio dell'applicazione.

Questa proprietà supporta il modello Applicazione di Visual Basic. Per ulteriori informazioni, vedere Cenni preliminari sul modello di applicazione Visual Basic.

Le modifiche apportate a questa proprietà vengono perse una volta chiusa l'applicazione. Affinché le modifiche apportate alla schermata iniziale vengano salvate in modo permanente, è necessario modificare l'impostazione in Progettazione progetti. Per ulteriori informazioni, vedere Procedura: specificare una schermata iniziale per un'applicazione (Visual Basic).

Esempio

In questo esempio, viene illustrato l'uso della proprietà My.Application.SplashScreen e dell'evento My.Application.Startup per aggiornare la schermata iniziale con le informazioni sullo stato all'avvio dell'applicazione.

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

Per questo esempio, è necessario che il progetto disponga di una schermata iniziale denominata SplashScreen1. È necessario che la schermata iniziale disponga di una proprietà denominata Status che aggiorna l'interfaccia utente.

Inserire il codice nella finestra editor del codice per gli eventi dell'applicazione. Per ulteriori informazioni, vedere Procedura: gestire gli eventi di applicazioni (Visual Basic).

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	No
Applicazione di console	No
Libreria di controlli Windows	No
Libreria di controllo Web	No
Servizio Windows	No
Sito Web	No