WindowsFormsApplicationBase.StartupNextInstance Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lors de la tentative de démarrer une application à instance unique et que l'application est déjà active.
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
Type d'événement
Exemples
Cet exemple utilise le e
paramètre du gestionnaire d’événements StartupNextInstance pour examiner les arguments de ligne de commande de l’application. Si un argument qui commence par /input=
, le reste de cet argument s’affiche.
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
Vous devez entrer le code dans la fenêtre Code Rédacteur pour les événements d’application. Pour accéder à cette fenêtre, suivez les instructions de la section Remarques de cette rubrique. Pour plus d'informations, consultez Application Page, Project Designer (Visual Basic).
Remarques
Une application instance unique déclenche l’événement StartupNextInstance lorsque vous tentez de redémarrer l’application alors qu’elle est déjà active. Lorsqu’une application mono-instance démarre pour la première fois, elle déclenche l’événementStartup. Pour plus d'informations, consultez Startup.
Cet événement fait partie du modèle d’application Visual Basic. Pour plus d’informations, consultez Vue d’ensemble du modèle d’application Visual Basic.
Cet événement est déclenché sur le thread main de l’application avec les autres événements d’interface utilisateur. Cela permet au gestionnaire d’événements d’accéder directement à l’interface utilisateur de l’application. Toutefois, si l’application est occupée à gérer un autre événement d’interface utilisateur lorsque cet événement est déclenché, cet événement ne peut pas être traité tant que l’autre gestionnaire d’événements n’a pas terminé ou appelé la DoEvents méthode.
Notes
L’événement StartupNextInstance
est déclenché uniquement dans les applications à instance unique. Pour activer le comportement d’une instance unique pour votre application, vous devez case activée la zone Créer un case activée d’application instance unique dans le Designer Projet.
Pour rendre une application unique instance |
1. Avec un projet sélectionné dans Explorateur de solutions, cliquez sur Propriétés dans le menu Projet. 2. Cliquez sur l’onglet Application. 3. Sélectionnez la zone Créer une case activée d’application instance unique. |
Vous devez utiliser la CommandLine propriété du e
paramètre pour accéder aux arguments pour les tentatives suivantes de démarrage d’une application à instance unique. La CommandLineArgs propriété fournit les arguments utilisés pour démarrer la première instance d’une application à instance unique.
Le code du StartupNextInstance gestionnaire d’événements est stocké dans le fichier ApplicationEvents.vb, qui est masqué par défaut.
Pour accéder à la fenêtre Code Rédacteur pour les événements d’application |
1. Avec un projet sélectionné dans Explorateur de solutions, cliquez sur Propriétés dans le menu Projet. 2. Cliquez sur l’onglet Application. 3. Cliquez sur le bouton Afficher les événements d’application pour ouvrir le code Rédacteur. Pour plus d'informations, consultez Application Page, Project Designer (Visual Basic). |
Le tableau suivant répertorie des exemples de tâches impliquant l’événement My.Application.StartupNextInstance
.
À | Consultez |
---|---|
Vérifiez les arguments de ligne de commande de la première application instance | CommandLineArgs |
Disponibilité par type de projet
Type de projet | Disponible |
---|---|
Application Windows Forms | Oui |
Bibliothèque de classes | Non |
Application console | Non |
Bibliothèque de contrôles Windows Forms | Non |
Bibliothèque de contrôles web | Non |
Service Windows | Non |
Site web | Non |
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour