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
Shldisp. h
MIDL
Shldisp. idl
DLL
Shell32.dll (version 5,0 ou ultérieure)