Shell. ShellExecute, méthode
Exécute une opération spécifiée sur un fichier spécifié.
Syntaxe
Langage
iRetVal = Shell.ShellExecute(
sFile,
[ vArguments ],
[ vDirectory ],
[ vOperation ],
[ vShow ]
);
VBScript
iRetVal = Shell.ShellExecute( _
sFile, _
[ ByVal vArguments ], _
[ ByVal vDirectory ], _
[ ByVal vOperation ], _
[ ByVal vShow ] _
)
VB :
Shell.ShellExecute( _
ByVal sFile As BSTR, _
[ ByVal vArguments As Variant ], _
[ ByVal vDirectory As Variant ], _
[ ByVal vOperation As Variant ], _
[ ByVal vShow As Variant ] _
) As Integer
Paramètres
-
sFile [ dans]
-
Type : BSTR
Chaîne qui contient le nom du fichier sur lequel ShellExecute effectue l’action spécifiée par vOperation.
-
vArguments [ dans, facultatif]
-
Type : variante
Chaîne qui contient les valeurs des paramètres de l’opération.
-
vDirectory [ dans, facultatif]
-
Type : variante
Chemin d’accès complet du répertoire qui contient le fichier spécifié par sFile. Si ce paramètre n’est pas spécifié, le répertoire de travail actuel est utilisé.
-
vOperation [ dans, facultatif]
-
Type : variante
Opération à effectuer. Cette valeur est définie sur l’une des chaînes de verbe qui est prise en charge par le fichier. Pour plus d’informations sur les verbes, consultez la section Notes. Si ce paramètre n’est pas spécifié, l’opération par défaut est effectuée.
-
vShow [ dans, facultatif]
-
Type : variante
Recommandation relative à l’affichage initial de la fenêtre d’application. L’application peut ignorer cette recommandation. Ce paramètre peut prendre les valeurs suivantes. Si ce paramètre n’est pas spécifié, l’application utilise sa valeur par défaut.
Valeur Signification - 0
Ouvrez l’application à l’aide d’une fenêtre masquée. - 1
Ouvrez l’application avec une fenêtre normale. Si la fenêtre est réduite ou agrandie, le système la restaure à sa taille et à sa position d’origine. - 2
Ouvrez l’application avec une fenêtre réduite. - 3
Ouvrez l’application avec une fenêtre agrandie. - 4
Ouvre l’application avec sa fenêtre à sa taille et à sa position les plus récentes. La fenêtre active reste active. - 5
Ouvre l’application avec sa fenêtre à sa taille et à sa position actuelles. - 7
Ouvrez l’application avec une fenêtre réduite. La fenêtre active reste active. - 10
Ouvre l’application avec sa fenêtre dans l’État par défaut spécifié par l’application.
Notes
Cette méthode est équivalente au lancement de l’une des commandes associées au menu contextuel d’un fichier. Chaque commande est représentée par une chaîne de verbe. L’ensemble des verbes pris en charge varie d’un fichier à un fichier. Le verbe le plus couramment pris en charge est « Open », qui est généralement le verbe par défaut. Les autres verbes peuvent être pris en charge uniquement par certains types de fichiers. Pour plus d’informations sur les verbes de Shell, consultez lancement d’applications ou extension des menus contextuels.
Cette méthode n’est pas disponible actuellement dans Microsoft Visual Basic.
Exemples
Les exemples suivants illustrent l’utilisation de ShellExecute pour ouvrir le bloc-notes. L’utilisation est indiquée pour JScript et VBScript.
Langage
function ShellExecuteJS()
{
var objShell = new ActiveXObject("Shell.Application");
objShell.ShellExecute("notepad.exe", "", "", "open", 1);
}
VBScript
Function ShellExecuteVB()
Dim objShell
Set objShell = CreateObject("Shell.Application")
Call objShell.ShellExecute("notepad.exe", "", "", "open", 1)
End Function
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 professionnel, applications de [ Bureau Windows XP uniquement] |
| Serveur minimal pris en charge |
Applications de bureau Windows Server 2003 [ uniquement] |
| En-tête |
|
| MIDL |
|
| DLL |
|