Propriedade My.Application.SplashScreen

Artigo
08/25/2010

Obtém ou configura a tela inicial para essa aplicação.

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

Valor de retorno

Valor de propriedade

Um objeto Form que o aplicativo utiliza como a tela inicial.

Exceções

A condição a seguir pode causar uma exceção:

O mesmo valor é atribuído a essa propriedade e a propriedade My.Application.MainForm (ArgumentNullException).

Comentários

A propriedade My.Application.SplashScreen permite que você obtenha ou definia o objeto Form que o aplicativo usa como o tela inicial, o primeiro formulário gráfico que é exibido enquanto um aplicativo está sendo iniciado.

Essa propriedade oferece suporte ao modelo de aplicativos Visual Basic.Para obter mais informações, consulte Visão Geral Sobre o Modelo do Aplicativo Visual Basic.

As alterações dessa propriedade não são mantidas quando o aplicativo for fechado.Para alterar a propriedade permanentemente, você deve alterar a configuração em Designer de Projeto :Para obter mais informações, consulte Como: Especifique uma tela inicial para um aplicativo (Visual Basic).

Exemplo

Este exemplo usa a propriedade My.Application.SplashScreen e o evento My.Application.Startup para atualizar o tela inicial com informações de status quando se inicia o aplicativo.

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

Esse exemplo requer que o projeto ter um tela inicial chamado SplashScreen1.A tela inicial precisa ter propriedade chamada Status que atualiza sua interface de usuário.

Você deve inserir esse código na janela Editor de Códigos para eventos do aplicativo.Para obter mais informações, consulte Como: Manipular eventos de aplicativo (Visual Basic).

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Não
Aplicativo de Console	Não
Biblioteca de Controle do Windows	Não
Biblioteca de Controle da Web	Não
Serviço do Windows	Não
Site	Não