WindowsFormsApplicationBase.StartupNextInstance Evento

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.ApplicationServices
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

Se produce cuando se intenta iniciar una aplicación de instancia única y la aplicación ya está activa.

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

Tipo de evento

StartupNextInstanceEventHandler

Ejemplos

En este ejemplo se usa el e parámetro del controlador de StartupNextInstance eventos para examinar los argumentos de la línea de comandos de la aplicación. Si se encuentra un argumento que comienza por /input=, se muestra el resto de ese argumento.

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

Debe escribir el código en la ventana Código Editor para eventos de aplicación. Para acceder a esta ventana, siga las instrucciones de la sección Comentarios de este tema. Para obtener más información, consulte Application Page, Project Designer (Visual Basic).

Comentarios

Una aplicación de instancia única genera el StartupNextInstance evento cuando se intenta reiniciar la aplicación cuando ya está activa. Cuando una aplicación de instancia única se inicia por primera vez, genera el Startup evento . Para obtener más información, vea Startup.

Este evento forma parte del modelo de aplicación de Visual Basic. Para obtener más información, vea Información general sobre el modelo de aplicación de Visual Basic.

Este evento se genera en el subproceso principal de la aplicación con los demás eventos de interfaz de usuario. Esto permite que el controlador de eventos acceda directamente a la interfaz de usuario de la aplicación. Sin embargo, si la aplicación está ocupada controlando otro evento de interfaz de usuario cuando se genera este evento, este evento no se puede procesar hasta que el otro controlador de eventos finalice o llame al DoEvents método .

Nota

El StartupNextInstance evento solo se genera en aplicaciones de instancia única. Para habilitar el comportamiento de instancia única para la aplicación, debe activar la casilla Crear aplicación de instancia única en project Designer.
Para crear una instancia única de aplicación
1. Con un proyecto seleccionado en Explorador de soluciones, haga clic en Propiedades en el menú Proyecto.
2. Haz clic en la pestaña Aplicación.
3. Active la casilla Make single instance application (Crear aplicación de instancia única ).

Debe usar la CommandLine propiedad del e parámetro para tener acceso a los argumentos de los intentos posteriores de iniciar una aplicación de instancia única. La CommandLineArgs propiedad proporciona los argumentos usados para iniciar la primera instancia de una aplicación de instancia única.

El código del StartupNextInstance controlador de eventos se almacena en el archivo ApplicationEvents.vb, que está oculto de forma predeterminada.
Para acceder a la ventana Código Editor para eventos de aplicación
1. Con un proyecto seleccionado en Explorador de soluciones, haga clic en Propiedades en el menú Proyecto.
2. Haz clic en la pestaña Aplicación.
3. Haga clic en el botón Ver eventos de aplicación para abrir el código Editor.

Para obtener más información, consulte Application Page, Project Designer (Visual Basic).

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Application.StartupNextInstance evento.

En Vea
Compruebe los argumentos de la línea de comandos de la primera instancia de aplicación. CommandLineArgs

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación de Windows Forms Sí
Biblioteca de clases No
Aplicación de consola No
Biblioteca de controles de Windows Forms No
Biblioteca de controles web No
Servicio de Windows No
Sitio web No

Se aplica a

Consulte también