WindowsFormsApplicationBase.StartupNextInstance Händelse

Definition

Namnområde:
Microsoft.VisualBasic.ApplicationServices
Sammansättning:
Microsoft.VisualBasic.dll

Inträffar när du försöker starta ett program med en instans och programmet redan är aktivt.

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

Händelsetyp

StartupNextInstanceEventHandler

Exempel

I det här exemplet används parametern e för StartupNextInstance händelsehanteraren för att undersöka programmets kommandoradsargument. Om ett argument hittas som börjar med /input=visas resten av argumentet.

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

Du måste ange koden i kodredigerarens fönster för programhändelser. Om du vill komma åt det här fönstret följer du anvisningarna i avsnittet Kommentarer i det här avsnittet. Mer information finns i Programsida, Projektdesigner (Visual Basic).

Kommentarer

Ett program med en instans genererar StartupNextInstance händelsen när du försöker starta om programmet när det redan är aktivt. När ett program med en instans startar för första gången genereras Startup händelsen. Mer information finns i Startup.

Den här händelsen är en del av Visual Basic-programmodellen. Mer information finns i Översikt över Visual Basic programmodell.

Den här händelsen aktiveras i programmets huvudtråd med de andra användargränssnittshändelserna. Detta gör att händelsehanteraren kan komma åt programmets användargränssnitt direkt. Men om programmet är upptaget med att hantera en annan händelse i användargränssnittet när den här händelsen aktiveras kan den här händelsen inte bearbetas förrän den andra händelsehanteraren har slutfört eller anropar DoEvents metoden.

Note

Händelsen StartupNextInstance genereras endast i program med en enda instans. Om du vill aktivera beteende för en enda instans för ditt program måste du markera kryssrutan Make single instance application i Project Designer.

Så här gör du en enskild programinstans:

  1. Med en project markerad i Prieskumník riešení klickar du på Egenskaper på menyn Project.
  2. Klicka på fliken Program .
  3. Markera kryssrutan Skapa program för enskild instans .|

Du måste använda CommandLine egenskapen för parametern e för att komma åt argumenten för efterföljande försök att starta ett program med en enda instans. Egenskapen CommandLineArgs innehåller argumenten som används för att starta den första instansen av ett program med en instans.

Koden för StartupNextInstance händelsehanteraren lagras i filen ApplicationEvents.vb, som är dold som standard.

För att komma åt kodredigerarens fönster för programhändelser: |1. Med en project markerad i Prieskumník riešení klickar du på Egenskaper på menyn Project.
2. Klicka på fliken Program .
3. Klicka på knappen Visa programhändelser för att öppna kodredigeraren.

Mer information finns på sidan Application, Project Designer (Visual Basic).|

I följande tabell visas exempel på uppgifter som involverar My.Application.StartupNextInstance händelsen.

Till Se
Kontrollera kommandoradsargumenten för den första programinstansen CommandLineArgs

Tillgänglighet efter projekttyp

Projekttyp Tillgängligt
Windows Forms program Yes
Klassbibliotek No
Konsolprogram No
Windows Forms kontrollbibliotek No
Webbkontrollbibliotek No
Windows-tjänsten No
Webbplats No

Gäller för

Se även