Table of contents
TOC
Réduire la table des matières
Développer la table des matières

Shell, fonction

office 365 dev account|Dernière mise à jour: 04/10/2017
|
1 Contributeur

Exécute un programme exécutable et retourne une variable Variant ( Double ) représentant l'ID de tâche du programme en cas de réussite. Dans le cas contraire, il renvoie zéro.

Syntaxe

Shell( chemin ** [ *, *stylefenêtre ** ] **)

La syntaxe de la fonction Shell dispose des arguments nommés suivants :

PartieDescription
cheminObligatoire. Variant ( String ). Nom du programme à exécuter et tout argument ou commutateur de ligne de commande requis ; peut inclure un répertoire ou un dossier et un lecteur. Sous Macintosh, vous pouvez utiliser la fonction MacID pour spécifier la signature d'une application à la place de son nom. L'exemple suivant utilise la signature pour Microsoft Word : Shell MacID("MSWD")
stylefenêtreFacultatif. Variant ( Integer ) correspondant au style de la fenêtre dans laquelle le programme doit s'exécuter. Si stylefenêtre n'est pas défini, le programme est démarré en mode réduit au premier plan. Sous Macintosh (OS 7.0 ou version ultérieure), stylefenêtre détermine uniquement si l'application est au premier plan lors de son exécution.

L'argument nommé stylefenêtre a les valeurs suivantes :

ConstanteValeurDescription
vbHide0La fenêtre est masquée et le focus est mis sur la fenêtre masquée. La constante vbHide n'est pas applicable sur les plateformes Macintosh.
vbNormalFocus1La fenêtre est mise au premier plan et est restauré à sa taille et sa position d'origine.
vbMinimizedFocus2La fenêtre est affichée sous forme d'icône au premier plan.
vbMaximizedFocus3La fenêtre est agrandie et au premier plan.
vbNormalNoFocus4La fenêtre est restaurée à sa taille et sa position la plus récente. La fenêtre active reste active.
vbMinimizedNoFocus6La fenêtre est affichée sous forme d'icône. La fenêtre active reste active.

Remarque

Si la fonction Shell exécute le fichier nommé, elle renvoie l'ID de tâche du programme démarré. L'ID de tâche est un numéro unique qui identifie le programme en cours d'exécution. Si la fonction Shell ne peut pas démarrer le programme nommé, une erreur se produit.

Sous Macintosh, les arguments vbNormalFocus, vbMinimizedFocus et vbMaximizedFocus placent tous l'application au premier plan ; les arguments vbHide, vbNoFocus et vbMinimizeFocus placent quant à eux l'application en arrière-plan.

Remarque Par défaut, la fonction Shell exécute d'autres programmes de façon asynchrone. Cela signifie qu'un programme démarré avec la fonction Shell peut ne pas arrêter de s'exécuter avant que les instructions suivant la fonction Shell soient exécutées.

Exemple

Cet exemple utilise la fonction Shell pour exécuter une application spécifiée par l'utilisateur. Sous Macintosh, le nom de lecteur par défaut est « HD » et les différentes parties du chemin sont séparées par des deux-points et non des barres obliques inverses. De même, vous devez spécifier des dossiers Macintosh et non \Windows.

' Specifying 1 as the second argument opens the application in
' normal size and gives it the focus.
Dim RetVal
RetVal = Shell("C:\WINDOWS\CALC.EXE", 1)    ' Run Calculator.
© 2018 Microsoft