Compartilhar via


WindowsFormsApplicationBase.SplashScreen Propriedade

Definição

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

A tela inicial do aplicativo.

Exceções

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

Aplica-se a

Confira também