WindowsFormsApplicationBase.StartupNextInstance Událost

Definice

Obor názvů:

Microsoft.VisualBasic.ApplicationServices

Sestavení:

Microsoft.VisualBasic.Forms.dll

Zdroj:

WindowsFormsApplicationBase.vb

Nastane při pokusu o spuštění aplikace s jednou instancí a aplikace je již aktivní.

public:
 event Microsoft::VisualBasic::ApplicationServices::StartupNextInstanceEventHandler ^ StartupNextInstance;

public event Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler StartupNextInstance;

member this.StartupNextInstance : Microsoft.VisualBasic.ApplicationServices.StartupNextInstanceEventHandler 

Public Event StartupNextInstance As StartupNextInstanceEventHandler 

Event Type

StartupNextInstanceEventHandler

Příklady

Tento příklad používá e parametr obslužné rutiny události k prozkoumání argumentů příkazového StartupNextInstance řádku aplikace. Pokud se najde argument začínající /input=na , zobrazí se zbytek tohoto 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

Kód je nutné zadat v okně Editor kódu pro události aplikace. Pokud chcete získat přístup k tomuto okně, postupujte podle pokynů v části Poznámky tohoto tématu. Další informace naleznete v tématu Stránka aplikace, Návrhář projektu (Visual Basic).

Poznámky

Aplikace s jednou instancí vyvolá událost při pokusu StartupNextInstance o restartování aplikace, když je již aktivní. Když se aplikace s jednou instancí spustí poprvé, vyvolá Startup událost. Další informace najdete na webu Startup.

Tato událost je součástí aplikačního modelu jazyka Visual Basic. Další informace najdete v tématu Přehled aplikačního modelu jazyka Visual Basic.

Tato událost je vyvolána v hlavním vlákně aplikace s ostatními událostmi uživatelského rozhraní. To umožňuje obslužné rutině události přistupovat přímo k uživatelskému rozhraní aplikace. Pokud je však aplikace zaneprázdněna zpracováním jiné události uživatelského rozhraní při vyvolání této události, nelze tuto událost zpracovat, dokud jiná obslužná rutina události nedokončí nebo volá metodu DoEvents .

Poznámka:

Událost StartupNextInstance je vyvolána pouze v aplikacích s jednou instancí. Chcete-li pro aplikaci povolit chování s jednou instancí, je nutné zaškrtnout políčko Vytvořit jednu instanci aplikace v Návrháři projektu.

Vytvoření jedné instance aplikace:

1. Pokud je projekt vybraný v Průzkumníku řešení, klikněte v nabídce Projekt na Příkaz Vlastnosti.
2. Klikněte na kartu Aplikace .
3. Zaškrtněte políčko Nastavit aplikaci jedné instance .|

Pro přístup k argumentům pro následné pokusy o spuštění aplikace s jednou instancí je nutné použít CommandLine vlastnost e parametru. Vlastnost CommandLineArgs poskytuje argumenty použité ke spuštění první instance aplikace s jednou instancí.

Kód obslužné rutiny StartupNextInstance události je uložen v souboru ApplicationEvents.vb, který je ve výchozím nastavení skrytý.

Přístup k okně Editoru kódu pro události aplikace: |1. Pokud je projekt vybraný v Průzkumníku řešení, klikněte v nabídce Projekt na Příkaz Vlastnosti.
2. Klikněte na kartu Aplikace .
3. Kliknutím na tlačítko Zobrazit události aplikace otevřete Editor kódu.

Další informace naleznete v tématu Stránka aplikace, Návrhář projektu (Visual Basic)|.

Následující tabulka uvádí příklady úkolů zahrnujících My.Application.StartupNextInstance událost.

To	Viz
Kontrola argumentů příkazového řádku první instance aplikace	CommandLineArgs

Dostupnost podle typu projektu

Typ projektu	K dispozici
Aplikace Windows Forms	Ano
Knihovna tříd	Ne
Konzolová aplikace	Ne
Knihovna ovládacích prvků Windows Forms	Ne
Knihovna webových ovládacích prvků	Ne
Služba systému Windows	Ne
Webu	Ne

Viz také

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• Objekty (Visual Basic)
• stránka aplikace, návrhář projektu (Visual Basic)
• Přehled aplikačního modelu jazyka Visual Basic