WindowsFormsApplicationBase.StartupNextInstance Evento

Definição

Espaço de Nomes:
Microsoft.VisualBasic.ApplicationServices
Assemblagem:
Microsoft.VisualBasic.dll

Ocorre ao tentar iniciar uma aplicação de instância única e esta já está ativa.

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

StartupNextInstanceEventHandler

Exemplos

Este exemplo utiliza o e parâmetro do StartupNextInstance gestor de eventos para examinar os argumentos da linha de comandos da aplicação. Se for encontrado um argumento que começa por /input=, o resto desse argumento é apresentado.

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

Deve introduzir o código na janela do Editor de Código para os eventos da aplicação. Para aceder a esta janela, siga as instruções da secção de Comentários deste tópico. Para obter mais informações, consulte Página de aplicativo, Project Designer (Visual Basic).

Observações

Uma aplicação de instância única gera o StartupNextInstance evento quando tenta reiniciar a aplicação estando já ativa. Quando uma aplicação de instância única inicia pela primeira vez, ela levanta o Startup evento. Para obter mais informações, veja Startup.

Este evento faz parte do modelo de aplicação Visual Basic. Para mais informações, consulte Visão Geral do Modelo de Aplicação Visual Basic.

Este evento é levantado no fio principal da aplicação juntamente com os outros eventos da interface de utilizador. Isto permite que o gestor de eventos aceda diretamente à interface de utilizador da aplicação. No entanto, se a aplicação estiver ocupada a tratar outro evento da interface de utilizador quando este evento é levantado, este evento não pode ser processado até que o outro gestor de eventos termine ou chame o DoEvents método.

Note

O StartupNextInstance evento é gerado apenas em aplicações de instância única. Para ativar o comportamento de uma única instância para a sua aplicação, deve assinalar a caixa Make single instance application no Project Designer.

Para tornar uma aplicação uma instância única:

  1. Com uma project selecionada em Explorador de Soluções, clique em Properties no menu Project.
  2. Clique no separador Aplicação.
  3. Selecione a opção Criar aplicação de instância única .|

Deve usar a CommandLine propriedade do e parâmetro para aceder aos argumentos para tentativas subsequentes de iniciar uma aplicação de instância única. A CommandLineArgs propriedade fornece os argumentos usados para iniciar a primeira instância de uma aplicação de instância única.

O código do StartupNextInstance gestor de eventos é armazenado no ficheiro ApplicationEvents.vb, que está oculto por defeito.

Para aceder à janela do Editor de Código para eventos de aplicação: |1. Com uma project selecionada em Explorador de Soluções, clique em Properties no menu Project.
2. Clique na guia Aplicativo .
3. Clique no botão Ver Eventos da Aplicação para abrir o Editor de Código.

Para mais informações, consulte Página de Candidatura, Project Designer (Visual Basic).|

A tabela seguinte lista exemplos de tarefas envolvendo o My.Application.StartupNextInstance evento.

Para Veja
Verifique os argumentos da linha de comandos da primeira instância de aplicação CommandLineArgs

Disponibilidade por tipo de projeto

Tipo de Projeto Available
Aplicação Windows Forms Yes
Biblioteca de Classes No
Aplicativo de console No
Biblioteca de Controlo Windows Forms No
Biblioteca de controle da Web No
Serviço Windows No
Web site No

Aplica-se a

Ver também