Condividi tramite


Proprietà My.Application.SplashScreen

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

Libreria di classi

No

Applicazione di console

No

Libreria di controlli Windows

No

Libreria di controllo Web

No

Servizio Windows

No

Sito Web

No

Autorizzazioni

Non sono richieste autorizzazioni.

Vedere anche

Riferimenti

Oggetto My.Application

Proprietà My.Application.MinimumSplashScreenDisplayTime

System.Windows.Forms.Form

WindowsFormsApplicationBase.SplashScreen