WindowsFormsApplicationBase.StartupNextInstance Evento

Definição

Ocorre durante a inicialização de um aplicativo de instância simples quando o aplicativo já está ativo.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;
public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;
member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 
Public Custom Event StartupNextInstance As StartupNextInstanceEventHandler 
Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Tipo de evento

Exemplos

Este exemplo usa o e parâmetro do manipulador de StartupNextInstance eventos para examinar os argumentos de linha de comando do aplicativo. Se for encontrado um argumento que comece com /input=, o restante desse argumento será exibido.

Private Sub MyApplication_StartupNextInstance(
    sender As Object,
    e As Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventArgs
) Handles Me.StartupNextInstance
    Dim inputArgument As String = "/input="
    Dim inputName As String = ""

    For Each s As String In e.CommandLine
        If s.ToLower.StartsWith(inputArgument) Then
            inputName = s.Remove(0, inputArgument.Length)
        End If
    Next

    If inputName = "" Then
        MsgBox("No input name")
    Else
        MsgBox("Input name: " & inputName)
    End If
End Sub

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 de instância única aciona o StartupNextInstance evento quando você tenta reiniciar o aplicativo quando ele já está ativo. Quando um aplicativo de instância única é iniciado pela primeira vez, ele aciona o Startup evento. Para obter mais informações, consulte Startup.

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.

Esse evento é gerado no thread principal do aplicativo com outros eventos de interface do usuário. Isso permite que o manipulador de eventos acesse diretamente a interface do usuário do aplicativo. No entanto, se o aplicativo estiver ocupado manipulando outro evento de interface do usuário quando esse evento for acionado, esse evento não poderá ser processado até que o outro manipulador de eventos seja concluído ou chame o DoEvents método .

Observação

O StartupNextInstance evento é gerado somente em aplicativos de instância única. Para habilitar o comportamento de instância única para seu aplicativo, marque a caixa de seleção Criar aplicativo de instância única no Designer de Projeto.

Para criar uma instância única do aplicativo
1. Com um projeto selecionado no Gerenciador de Soluções, clique em Propriedades no menu Projeto .
2. Clique na guia Aplicativo.
3. Marque a caixa de seleção Tornar aplicativo de instância única .

Você deve usar a CommandLine propriedade do e parâmetro para acessar os argumentos para tentativas subsequentes de iniciar um aplicativo de instância única. A CommandLineArgs propriedade fornece os argumentos usados para iniciar a primeira instância de um aplicativo de instância única.

O código do StartupNextInstance 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).

A tabela a seguir lista exemplos de tarefas que envolvem o My.Application.StartupNextInstance evento.

Para Consulte
Verificar os argumentos de linha de comando da primeira instância do aplicativo CommandLineArgs

Disponibilidade por tipo de projeto

Tipo de projeto Disponível
Aplicativo do Windows Forms Yes
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