WindowsFormsApplicationBase.StartupNextInstance イベント

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 

イベントの種類

例

この例では、 e イベント ハンドラーの パラメーターを StartupNextInstance 使用して、アプリケーションのコマンド ライン引数を調べます。 で /input=始まる引数が見つかった場合は、その引数の残りの部分が表示されます。

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

アプリケーション イベントの [コード エディター] ウィンドウにコードを入力する必要があります。 このウィンドウにアクセスするには、このトピックの「解説」セクションの手順に従います。 詳細については、「[アプリケーション] ページ (プロジェクト デザイナー) (Visual Basic)」を参照してください。

注釈

単一インスタンス アプリケーションは、既に StartupNextInstance アクティブなときにアプリケーションを再起動しようとすると、 イベントを発生させます。 単一インスタンス アプリケーションが初めて起動すると、 イベントが発生します Startup 。 詳細については、「Startup」を参照してください。

このイベントは、Visual Basic アプリケーション モデルの一部です。 詳細については、「 Visual Basic アプリケーション モデルの概要」を参照してください。

このイベントは、他のユーザー インターフェイス イベントを使用して、アプリケーションのメイン スレッドで発生します。 これにより、イベント ハンドラーはアプリケーションのユーザー インターフェイスに直接アクセスできます。 ただし、このイベントが発生したときにアプリケーションが別のユーザー インターフェイス イベントの処理にビジー状態になっている場合は、他のイベント ハンドラーが メソッドを終了または呼び出すまで、このイベントを DoEvents 処理できません。

パラメーターの プロパティをCommandLinee使用して、後続の単一インスタンス アプリケーションの起動試行の引数にアクセスする必要があります。 プロパティは CommandLineArgs 、単一インスタンス アプリケーションの最初のインスタンスを開始するために使用される引数を提供します。

イベント ハンドラーの StartupNextInstance コードは、既定では非表示になっているApplicationEvents.vb ファイルに格納されます。

次の表に、 イベントに関連するタスクの例を My.Application.StartupNextInstance 示します。

プロジェクトの種類別の可用性

適用対象

こちらもご覧ください

• Startup
• CommandLineArgs
• StartupEventArgs
• CommandLine
• オブジェクト (Visual Basic)
• [アプリケーション] ページ (プロジェクト デザイナー)
• Visual Basic アプリケーション モデルの概要