Méthode Shell.ShellExecute

Effectue une opération spécifiée sur un fichier spécifié.

Syntaxe

Jscript:

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 [in]

Type : BSTR

Chaîne qui contient le nom du fichier sur lequel ShellExecute effectuera l’action spécifiée par vOperation.

vArguments [in, facultatif]

Type : Variant

Chaîne qui contient des valeurs de paramètre pour l’opération.

vDirectory [in, facultatif]

Type : Variant

Chemin 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 [in, facultatif]

Type : Variant

Opération à effectuer. Cette valeur est définie sur l’une des chaînes de verbes prises en charge par le fichier. Pour une discussion sur les verbes, consultez la section Remarques. Si ce paramètre n’est pas spécifié, l’opération par défaut est effectuée.

vShow [in, facultatif]

Type : Variant

Recommandation concernant la façon dont la fenêtre d’application doit être affichée initialement. 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 avec 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	Ouvrez l’application avec sa fenêtre à la taille et à la position les plus récentes. La fenêtre active reste active.
5	Ouvrez l’application avec sa fenêtre à la taille et à la position actuelles.
7	Ouvrez l’application avec une fenêtre réduite. La fenêtre active reste active.
10	Ouvrez l’application avec sa fenêtre dans l’état par défaut spécifié par l’application.

 

Notes

Cette méthode équivaut à lancer 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 de verbes pris en charge varie d’un fichier à l’autre. Le verbe le plus couramment pris en charge est « open », qui est également généralement le verbe par défaut. D’autres verbes peuvent être pris en charge uniquement par certains types de fichiers. Pour plus d’informations sur les verbes shell, consultez Lancement d’applications ou Extension des menus contextuels.

Cette méthode n’est actuellement pas disponible dans Microsoft Visual Basic.

Exemples

Les exemples suivants montrent l’utilisation de ShellExecute pour ouvrir le Bloc-notes. L’utilisation est indiquée pour JScript et VBScript.

Jscript:

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Shldisp.h
IDL	Shldisp.idl
DLL	Shell32.dll (version 5.0 ou ultérieure)