Interaction.AppActivate Méthode
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.
Active une application qui est déjà en cours d'exécution.
Surcharges
| AppActivate(Int32) |
Active une application qui est déjà en cours d'exécution. |
| AppActivate(String) |
Active une application qui est déjà en cours d'exécution. |
AppActivate(Int32)
- Source:
- Interaction.vb
- Source:
- Interaction.vb
- Source:
- Interaction.vb
Active une application qui est déjà en cours d'exécution.
public:
static void AppActivate(int ProcessId);public static void AppActivate (int ProcessId);static member AppActivate : int -> unitPublic Sub AppActivate (ProcessId As Integer)Paramètres
- ProcessId
- Int32
Integer spécifiant le numéro d'ID de processus Win32 assigné à ce processus. Vous pouvez utiliser l'ID retourné par la Shell(String, AppWinStyle, Boolean, Int32), à condition que sa valeur soit différente de zéro.
Exemples
Cet exemple illustre différentes utilisations de la AppActivate fonction pour activer une fenêtre d’application. Si un processus du Bloc-notes n’est pas en cours d’exécution, l’exemple lève une ArgumentException. La procédure Shell suppose que les applications se trouvent dans les chemins spécifiés.
Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.
AppActivate(notepadID)
Remarques
Vous utilisez AppActivate pour mettre la fenêtre active d’une application en focus. Vous n’avez peut-être pas de handle ou de référence à la fenêtre active, ou même de savoir quelle fenêtre est active à un moment donné. Dans ce cas, vous ne pouvez pas utiliser la Focus méthode .
La AppActivate fonction remplace le focus sur l’application ou la fenêtre nommée, mais n’affecte pas si elle est agrandie ou réduite. Le focus s’éloigne de la fenêtre d’application activée lorsque l’utilisateur prend une action pour modifier le focus ou fermer la fenêtre. Vous pouvez utiliser la Shell fonction pour démarrer une application et définir le style de fenêtre.
Si vous utilisez le Title paramètre , AppActivate utilise une comparaison qui ne respecte pas la casse, mais nécessite une correspondance exacte avec le contenu de la barre de titre. Il examine d’abord les fenêtres de niveau supérieur, puis les fenêtres enfants. S’il ne trouve pas de correspondance, il lève un ArgumentException.
Vous pouvez utiliser AppActivate uniquement avec des processus qui possèdent des fenêtres. La plupart des applications console ne possèdent pas de fenêtres, ce qui signifie qu’elles n’apparaissent pas dans la liste des processus qui effectuent AppActivate la recherche. Lors de l’exécution à partir d’une application console, le système crée un processus distinct pour exécuter l’application et retourne la sortie au processus de console. Par conséquent, lorsque vous demandez l’ID de processus actuel, vous obtenez l’ID de processus de ce processus distinct, plutôt que l’ID de processus de l’application console.
Au moment de l’exécution, la AppActivate fonction active toute application en cours d’exécution avec un titre qui correspond Title ou avec un ID de processus qui correspond ProcessIdà . S’il n’existe aucune correspondance exacte, elle active toute application dont la chaîne de titre se termine par Title. S’il existe plusieurs applications nommées Title, la AppActivate fonction en choisit arbitrairement une à activer.
Notes
La AppActivate fonction nécessite UIPermission au SafeTopLevelWindows niveau, ce qui peut affecter son exécution dans des situations de confiance partielle. Pour plus d'informations, consultez UIPermission.
Voir aussi
S’applique à
AppActivate(String)
- Source:
- Interaction.vb
- Source:
- Interaction.vb
- Source:
- Interaction.vb
Active une application qui est déjà en cours d'exécution.
public:
static void AppActivate(System::String ^ Title);public static void AppActivate (string Title);static member AppActivate : string -> unitPublic Sub AppActivate (Title As String)Paramètres
- Title
- String
Expression String spécifiant le titre figurant dans la barre de titre de l'application que vous souhaitez activer. Vous pouvez utiliser le titre assigné à l'application lorsqu'elle a été lancée.
Exemples
Cet exemple illustre différentes utilisations de la AppActivate fonction pour activer une fenêtre d’application. Si un processus du Bloc-notes n’est pas en cours d’exécution, l’exemple lève une ArgumentException. La procédure Shell suppose que les applications se trouvent dans les chemins spécifiés.
Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.
AppActivate(notepadID)
Remarques
Vous utilisez AppActivate pour mettre la fenêtre active d’une application en focus. Vous n’avez peut-être pas de handle ou de référence à la fenêtre active, ou même de savoir quelle fenêtre est active à un moment donné. Dans ce cas, vous ne pouvez pas utiliser la Focus méthode .
La AppActivate fonction remplace le focus sur l’application ou la fenêtre nommée, mais n’affecte pas si elle est agrandie ou réduite. Le focus s’éloigne de la fenêtre d’application activée lorsque l’utilisateur prend une action pour modifier le focus ou fermer la fenêtre. Vous pouvez utiliser la Shell fonction pour démarrer une application et définir le style de fenêtre.
Si vous utilisez le Title paramètre , AppActivate utilise une comparaison qui ne respecte pas la casse, mais nécessite une correspondance exacte avec le contenu de la barre de titre. Il examine d’abord les fenêtres de niveau supérieur, puis les fenêtres enfants. S’il ne trouve pas de correspondance, il lève un ArgumentException.
Vous pouvez utiliser AppActivate uniquement avec des processus qui possèdent des fenêtres. La plupart des applications console ne possèdent pas de fenêtres, ce qui signifie qu’elles n’apparaissent pas dans la liste des processus qui effectuent AppActivate la recherche. Lors de l’exécution à partir d’une application console, le système crée un processus distinct pour exécuter l’application et retourne la sortie au processus de console. Par conséquent, lorsque vous demandez l’ID de processus actuel, vous obtenez l’ID de processus de ce processus distinct, plutôt que l’ID de processus de l’application console.
Au moment de l’exécution, la AppActivate fonction active toute application en cours d’exécution avec un titre qui correspond Title ou avec un ID de processus qui correspond ProcessIdà . S’il n’existe aucune correspondance exacte, elle active toute application dont la chaîne de titre se termine par Title. S’il existe plusieurs applications nommées Title, la AppActivate fonction en choisit arbitrairement une à activer.
Notes
La AppActivate fonction nécessite UIPermission au SafeTopLevelWindows niveau, ce qui peut affecter son exécution dans des situations de confiance partielle. Pour plus d'informations, consultez UIPermission.
