WindowsFormsApplicationBase.StartupNextInstance Evento

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 .

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.

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

Disponibilidade por tipo de projeto

Aplica-se a

Confira também

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Objetos (Visual Basic)
• Página de Aplicativo, Designer de Projeto (Visual Basic)
• Visão geral do modelo de aplicativo do Visual Basic