WindowsFormsApplicationBase.Startup Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o aplicativo é iniciado.
public:
event Microsoft::VisualBasic::ApplicationServices::StartupEventHandler ^ Startup;public event Microsoft.VisualBasic.ApplicationServices.StartupEventHandler Startup;member this.Startup : Microsoft.VisualBasic.ApplicationServices.StartupEventHandler Public Custom Event Startup As StartupEventHandler Public Event Startup As StartupEventHandler Tipo de evento
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 o código na janela Editor de Código para eventos de aplicativo. Para acessar essa janela, siga as instruções da seção Comentários deste tópico. Para obter mais informações, consulte Página de aplicativo, Designer de Projeto (Visual Basic).
Comentários
Um aplicativo normal (não de instância única) aciona o Startup evento sempre que ele é iniciado. Um aplicativo de instância única aciona o Startup evento quando ele é iniciado somente se o aplicativo ainda não estiver ativo; caso contrário, ele aciona o StartupNextInstance evento. Para obter mais informações, consulte StartupNextInstance.
Esse evento faz parte do modelo de aplicativo do Visual Basic. Para obter mais informações, consulte Visão geral do Modelo de Aplicativo do Visual Basic.
Você pode usar a Cancel propriedade do e parâmetro para controlar o carregamento do formulário de inicialização de um aplicativo. Quando a Cancel propriedade é definida Truecomo , o formulário de inicialização não é iniciado. Nesse caso, seu código deve chamar um caminho de código de inicialização alternativo.
Você pode usar a CommandLine propriedade do e parâmetro ou da CommandLineArgs propriedade para acessar os argumentos de linha de comando do aplicativo.
O código do Startup manipulador de eventos é armazenado no arquivo ApplicationEvents.vb, que está oculto por padrão.
| Para acessar a janela editor de código para eventos de aplicativo |
| 1. Com um projeto selecionado no Gerenciador de Soluções, clique em Propriedades no menu Projeto . 2. Clique na guia Aplicativo. 3. Clique no botão Exibir Eventos do Aplicativo para abrir o Editor de Códigos. Para obter mais informações, consulte Página de aplicativo, Designer de Projeto (Visual Basic). |
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 |
