WindowsFormsApplicationBase.StartupNextInstance Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce al intentar 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
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 Editor de código 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, vea Página aplicación, Diseñador de proyectos (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, consulte Startup.
Este evento forma parte del modelo de aplicación de Visual Basic. Para obtener más información, vea Introducción al 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 al controlador de eventos acceder 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 el Diseñador de proyectos.
Para crear una instancia única de aplicación:
- Con un proyecto seleccionado en el Explorador de soluciones, haga clic en Propiedades en el menú Proyecto .
- Haga clic en la pestaña Aplicación .
- 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 Editor de código para eventos de aplicación: |1. Con un proyecto seleccionado en el Explorador de soluciones, haga clic en Propiedades en el menú Proyecto .
2. Haga clic en la pestaña Aplicación .
3. Haga clic en el botón Ver eventos de aplicación para abrir el Editor de código.
Para obtener más información, vea Página aplicación, Diseñador de proyectos (Visual Basic)||
En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Application.StartupNextInstance evento.
| Para | 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 Formularios Windows Forms | No |
| Biblioteca de controles web | No |
| Servicio de Windows | No |
| Sitio web | No |
