Interaction.AppActivate Méthode

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Active une application déjà en cours d’exécution.

Surcharges

Nom Description
AppActivate(Int32)

Active une application déjà en cours d’exécution.
AppActivate(String)

Active une application déjà en cours d’exécution.

AppActivate(Int32)

Active une application déjà en cours d’exécution.

public:
 static void AppActivate(int ProcessId);
public static void AppActivate(int ProcessId);
static member AppActivate : int -> unit
Public Sub AppActivate (ProcessId As Integer)

Paramètres

ProcessId
Int32

Integer spécification du numéro d’ID de processus Win32 affecté à ce processus. Vous pouvez utiliser l’ID retourné par le Shell(String, AppWinStyle, Boolean, Int32), à condition qu’il ne soit pas égal à zéro.

Exemples

Cet exemple illustre différentes utilisations de la AppActivate fonction pour activer une fenêtre d’application. Si un processus de Bloc-notes n’est pas en cours d’exécution, l’exemple génère une ArgumentException. La Shell procédure 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 le focus sur la fenêtre active d’une application. Vous ne disposez peut-être pas d’un handle ou d’une 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 modifie 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 effectue 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 paramètre, AppActivate utilise une comparaison non sensible à la Title casse, mais nécessite sinon 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 ne pouvez utiliser AppActivate que les 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 AppActivate effectuent des recherches. 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 correspondant 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 choisit arbitrairement une application à activer.

Note

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)

Active une application déjà en cours d’exécution.

public:
 static void AppActivate(System::String ^ Title);
public static void AppActivate(string Title);
static member AppActivate : string -> unit
Public Sub AppActivate (Title As String)

Paramètres

Title
String

String expression spécifiant le titre dans la barre de titre de l’application que vous souhaitez activer. Vous pouvez utiliser le titre affecté à l’application lors du lancement.

Exemples

Cet exemple illustre différentes utilisations de la AppActivate fonction pour activer une fenêtre d’application. Si un processus de Bloc-notes n’est pas en cours d’exécution, l’exemple génère une ArgumentException. La Shell procédure 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 le focus sur la fenêtre active d’une application. Vous ne disposez peut-être pas d’un handle ou d’une 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 modifie 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 effectue 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 paramètre, AppActivate utilise une comparaison non sensible à la Title casse, mais nécessite sinon 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 ne pouvez utiliser AppActivate que les 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 AppActivate effectuent des recherches. 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 correspondant 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 choisit arbitrairement une application à activer.

Note

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 à