UDF > WinAPIEx > ShellEx >


_WinAPI_ShellExecute

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

#include <WinAPIShellEx.au3>
_WinAPI_ShellExecute ( $sFilePath [, $sArgs = '' [, $sDir = '' [, $sVerb = '' [, $iShow = 1 [, $hParent = 0]]]]] )

Paramètres

$sFilePath La chaîne qui spécifie le fichier ou l'objet sur lequel exécuter le verbe spécifié. A noter que pas tous les verbes sont pris en charge sur tous les objets. Par exemple, tous les types de documents soutiennent le verbe "print".
$sArgs [optionnel] La chaîne qui spécifie les paramètres à passer à l'application.
$sDir [optionnel] La chaîne qui spécifie le répertoire de travail pour l'action.
$sVerb [optionnel] La chaîne, considérée comme un verbe, qui spécifie l'action à effectuer. L'ensemble des verbes disponibles dépend du fichier ou dossier particulier. Généralement, les actions disponibles par les raccourcis d'un objet Menu sont les verbes disponibles. Les verbes suivants sont couramment utilisés:

"edit"
"explorer"
"find"
"open"
"edit"
"print"
$iShow [optionnel] Les flags qui spécifient comment une application doit être affichée quand elle est ouverte ($SW_*).
$hParent [optionnel] Handle de la fenêtre propriétaire utilisée pour afficher une interface utilisateur ou des messages d'erreur.

Valeur de retour

Succès: Retourne True.
Échec: Retourne False, @extended peut contenir une valeur d'erreur qui indique la cause de l'échec. Il peut prendre l'une des valeurs suivantes (à l'exclusion de (-1 )).
Le système d'exploitation est en dehors de la mémoire ou des ressources (0)
ERROR_FILE_NOT_FOUND (2)
ERROR_PATH_NOT_FOUND (3)
ERROR_BAD_FORMAT (11)
SE_ERR_*

Voir aussi

Consultez ShellExecute dans la librairie MSDN.

Exemple

#include <MsgBoxConstants.au3>
#include <WinAPIShellEx.au3>

Local $sFile = InputBox('Run', 'Tapez le nom d''un programme, dossier, document, ou ressource Internet pour l''ouvrir', '', '', 368, 152)

If $sFile Then
    _WinAPI_ShellExecute($sFile, '', '', 'open')
    If @error Then
        MsgBox(BitOR($MB_ICONERROR, $MB_SYSTEMMODAL), 'Erreur', 'Impossible d''ouvrir "' & $sFile & '".' & @CRLF & @CRLF & @extended)
    EndIf
EndIf