WindowsFormsApplicationBase.SplashScreen Propriedade

Definição

Namespace:

Microsoft.VisualBasic.ApplicationServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Origem:

WindowsFormsApplicationBase.vb

Obtém ou define a tela inicial deste aplicativo.

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

Valor da propriedade

Form

A tela inicial do aplicativo.

Exceções

ArgumentNullException

O mesmo valor é atribuído a essa propriedade e à propriedade MainForm.

Exemplos

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

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

Este exemplo requer que o projeto tenha uma tela inicial chamada SplashScreen1. A tela inicial precisa ter uma propriedade chamada Status que atualize sua interface do usuário.

Você deve inserir esse código na janela Editor de Código para eventos de aplicativo. Para obter mais informações, consulte Página de aplicativo, Designer de Projeto (Visual Basic).

Comentários

A My.Application.SplashScreen propriedade permite que você obtenha ou defina o Form objeto que o aplicativo usa como a tela inicial, a primeira forma gráfica exibida enquanto um aplicativo está sendo iniciado.

Essa propriedade dá suporte ao modelo de aplicativo do Visual Basic. Para obter mais informações, consulte Visão geral do Modelo de Aplicativo do Visual Basic.

As alterações nessa propriedade não são persistidas quando o aplicativo é fechado. Para alterar a tela inicial permanentemente, você deve alterar a configuração no Designer de Projeto.

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows Forms	Sim
Biblioteca de Classes	Não
Aplicativo do Console	Não
Biblioteca de Controle Windows Forms	Não
Biblioteca de Controles da Web	Não
Serviço do Windows	Não
Site	Não

Confira também

• MinimumSplashScreenDisplayTime
• Form
• Objetos (Visual Basic)