Interaction.AppActivate, méthode (String)
Active une application qui est déjà en cours d'exécution.
Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)
Syntaxe
'Déclaration
Public Shared Sub AppActivate ( _
Title As String _
)
'Utilisation
Dim Title As String
Interaction.AppActivate(Title)
public static void AppActivate (
string Title
)
public:
static void AppActivate (
String^ Title
)
public static void AppActivate (
String Title
)
public static function AppActivate (
Title : String
)
Paramètres
- Title
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.
Notes
Pour plus d'informations, consultez la rubrique Visual Basic AppActivate, fonction.
Pour donner le focus à la fenêtre active de l'application, utilisez AppActivate. Vous pouvez ne pas avoir de handle ou de référence à la fenêtre active, ni même savoir quelle fenêtre est active à un moment donné. Dans un tel cas, vous ne pouvez pas utiliser la méthode Focus.
La fonction AppActivate déplace le focus sur l'application ou la fenêtre nommée, mais ne l'agrandit ni ne la réduit. La fenêtre d'application cesse d'être active dès que l'utilisateur exécute une action qui entraîne la fermeture de la fenêtre ou l'activation d'une autre. Vous pouvez utiliser la fonction Shell pour démarrer une application et définir le style de la fenêtre.
Si vous utilisez le paramètre Title, AppActivate utilise une comparaison qui ne respecte pas la casse, mais requiert par ailleurs une correspondance exacte avec le contenu de la barre de titre. Elle parcourt d'abord les fenêtres de niveau supérieur, puis les fenêtres enfants. Si aucune correspondance n'est trouvée, elle lève une exception ArgumentException.
Vous ne pouvez utiliser AppActivate qu'avec des processus contenant 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 de processus que recherche AppActivate. 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 le résultat au processus console. Par conséquent, lorsque vous demandez l'ID du processus actuel, vous obtenez l'ID de ce processus distinct à la place de celui de l'application console.
Au moment de l'exécution, la fonction AppActivate active toute application en cours d'exécution avec un titre qui correspond à Title ou avec un ID de processus qui correspond à ProcessId. Si aucun titre ne correspond exactement à l'argument, une application dont le titre se termine par Title est activée. Si plusieurs applications sont nommées Title, la fonction AppActivate choisit arbitrairement d'en activer une.
Notes
La fonction AppActivate nécessite UIPermission au niveau SafeTopLevelWindows, ce qui peut affecter son exécution dans les situations où le niveau de confiance n'est pas total. Pour plus d'informations, consultez Demande d'autorisations et UIPermission, classe.
Exemple
Cet exemple montre comment utiliser la fonction AppActivate pour activer une fenêtre d'application. Si un processus Notepad n'est pas en cours d'exécution, l'exemple lève une exception ArgumentException. La procédure Shell employée suppose que les applications se trouvent dans les chemins d'accès 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)
Plates-formes
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Informations de version
.NET Framework
Prise en charge dans : 2.0, 1.1, 1.0
.NET Compact Framework
Prise en charge dans : 2.0
Voir aussi
Référence
Interaction, classe
Membres Interaction
Microsoft.VisualBasic, espace de noms
Focus
ArgumentException