Udostępnij za pośrednictwem


WindowsFormsApplicationBase.StartupNextInstance Zdarzenie

Definicja

Występuje podczas próby uruchomienia aplikacji z pojedynczym wystąpieniem, a aplikacja jest już aktywna.

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 

Typ zdarzenia

Przykłady

W tym przykładzie użyto e parametru StartupNextInstance procedury obsługi zdarzeń do zbadania argumentów wiersza polecenia aplikacji. Jeśli zostanie znaleziony argument rozpoczynający się od /input=, zostanie wyświetlona pozostała część tego argumentu.

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

Musisz wprowadzić kod w oknie Edytor kodu dla zdarzeń aplikacji. Aby uzyskać dostęp do tego okna, postępuj zgodnie z instrukcjami w sekcji Uwagi tego tematu. Aby uzyskać więcej informacji, zobacz Strona aplikacji, Project Designer (Visual Basic).

Uwagi

Aplikacja z pojedynczym wystąpieniem zgłasza StartupNextInstance zdarzenie podczas próby ponownego uruchomienia aplikacji, gdy jest już aktywna. Gdy aplikacja z pojedynczym wystąpieniem jest uruchamiana po raz pierwszy, zgłasza Startup zdarzenie. Aby uzyskać więcej informacji, zobacz Startup.

To zdarzenie jest częścią modelu aplikacji Visual Basic. Aby uzyskać więcej informacji, zobacz Omówienie modelu aplikacji Visual Basic.

To zdarzenie jest wywoływane w głównym wątku aplikacji z innymi zdarzeniami interfejsu użytkownika. Dzięki temu program obsługi zdarzeń może uzyskiwać dostęp bezpośrednio do interfejsu użytkownika aplikacji. Jeśli jednak aplikacja jest zajęta obsługą innego zdarzenia interfejsu użytkownika po wystąpieniu tego zdarzenia, nie można przetworzyć tego zdarzenia, dopóki inny program obsługi zdarzeń nie zakończy działania lub wywoła metodę DoEvents .

Uwaga

Zdarzenie StartupNextInstance jest wywoływane tylko w aplikacjach z pojedynczym wystąpieniem. Aby włączyć zachowanie pojedynczego wystąpienia dla aplikacji, należy zaznaczyć pole wyboru Utwórz aplikację pojedynczego wystąpienia w Projektancie projektów.

Tworzenie pojedynczego wystąpienia aplikacji
1. Po wybraniu projektu w Eksploratorze rozwiązań kliknij polecenie Właściwości w menu Projekt .
2. Kliknij kartę Aplikacja .
3. Zaznacz pole wyboru Utwórz aplikację pojedynczego wystąpienia .

Aby uzyskać dostęp do argumentów kolejnych prób uruchomienia aplikacji z pojedynczym wystąpieniem, należy użyć CommandLine właściwości e parametru . Właściwość CommandLineArgs udostępnia argumenty używane do uruchamiania pierwszego wystąpienia aplikacji z jednym wystąpieniem.

Kod programu obsługi zdarzeń StartupNextInstance jest przechowywany w pliku ApplicationEvents.vb, który jest domyślnie ukryty.

Aby uzyskać dostęp do okna Edytora kodu dla zdarzeń aplikacji
1. Po wybraniu projektu w Eksploratorze rozwiązań kliknij polecenie Właściwości w menu Projekt .
2. Kliknij kartę Aplikacja .
3. Kliknij przycisk Wyświetl zdarzenia aplikacji , aby otworzyć Edytor kodu.

Aby uzyskać więcej informacji, zobacz Strona aplikacji, Project Designer (Visual Basic).

W poniższej tabeli wymieniono przykłady zadań związanych ze zdarzeniem My.Application.StartupNextInstance .

Działanie Zobacz
Sprawdź argumenty wiersza polecenia pierwszego wystąpienia aplikacji CommandLineArgs

Dostępność według typu projektu

Project type (Typ projektu) Dostępne
Aplikacja interfejsu Windows Forms Tak
Biblioteka klas Nie
Aplikacja konsoli Nie
Biblioteka formantów interfejsu Windows Forms Nie
Biblioteka formantów sieci Web Nie
Usługa systemu Windows Nie
Witryna sieci Web Nie

Dotyczy

Zobacz też