WindowsFormsApplicationBase.StartupNextInstance Událost

Definice

Obor názvů:

Microsoft.VisualBasic.ApplicationServices

Sestavení:

Microsoft.VisualBasic.Forms.dll

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é StartupNextInstance rutiny události ke kontrole argumentů příkazového řádku aplikace. Pokud se najde argument, který začíná /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 musíte zadat do okna Code Editor pro události aplikace. K tomuto okně se dostanete podle pokynů v části Poznámky k tomuto tématu. Další informace najdete v tématu Stránka aplikace, Project Designer (Visual Basic).

Poznámky

Aplikace s jednou instancí vyvolá StartupNextInstance událost při pokusu o restartování aplikace, když je již aktivní. Při prvním spuštění aplikace s jednou instancí vyvolá Startup událost. Další informace naleznete v tématu 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 spolu 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 se obslužná rutina jiné události nedokončí nebo nevolá metodu DoEvents .

Poznámka

Událost StartupNextInstance je vyvolána pouze v aplikacích s jednou instancí. Pokud chcete pro aplikaci povolit chování s jednou instancí, je nutné zaškrtnout políčko Vytvořit aplikaci s jednou instancí v aplikaci Project Designer.

Vytvoření jedné instance aplikace
1. S vybraným projektem v Průzkumník řešení klepněte na tlačítko Vlastnosti v nabídce Projekt. 2. Klikněte na kartu Aplikace . 3. Zaškrtněte políčko Vytvořit aplikaci s jednou instancí .

Vlastnost parametru e musíte použít CommandLine pro přístup k argumentům pro následné pokusy o spuštění aplikace s jednou instancí. 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ě Editor kódu pro události aplikace
1. S vybraným projektem v Průzkumník řešení klepněte na tlačítko Vlastnosti v nabídce Projekt. 2. Klikněte na kartu Aplikace . 3. Kliknutím na tlačítko Zobrazit události aplikace otevřete Editor kódu. Další informace najdete v tématu Stránka aplikace, Project Designer (Visual Basic).

V následující tabulce jsou uvedeny příklady úkolů zahrnujících událost My.Application.StartupNextInstance .

Záměr	Seznamte se s
Kontrola argumentů příkazového řádku první instance aplikace	CommandLineArgs

Dostupnost podle typu projektu

Typ projektu	K dispozici.
Formulářová aplikace Windows	Yes
Knihovna tříd	No
Konzolová aplikace	No
Knihovna ovládacích prvků formulářů Windows	No
Knihovna webových ovládacích prvků	No
Služba systému Windows	No
Webu	No

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