Functions > Process >

ShellExecute

Ex�cute un programme externe en utilisant l'API ShellExecute.

ShellExecute ( "filename" [, "parameters" [, "workingdir" [, "verb" [, showflag]]]] )

Param�tres

filename Le nom du fichier � ex�cuter (.exe, .txt, .lnk, etc..).
parameters [optionnel] Les param�tres du programme. Vide ("") si aucun.
workingdir [optionnel] Le r�pertoire de travail. Si vide (""), utilise le r�pertoire de travail courant.
verb [optionnel] Le "verbe" � utiliser, les verbes courants sont:
    $SHEX_OPEN ("open") = Ouvre le fichier sp�cifi�. Le fichier peut �tre un fichier ex�cutable, un fichier document ou un dossier
    $SHEX_EDIT ("edit") = lance un �diteur et ouvre le document pour l'�diter. Si "filename" n'est pas un fichier de document, la fonction �chouera
    $SHEX_PRINT ("print") = Imprime le fichier de document sp�cifi�. Si "filename"n'est pas un fichier de document, la fonction �chouera
    $SHEX_PROPERTIES ("properties") = Affiche les propri�t�s d'un fichier ou d'un dossier
Voir Remarques pour plus d'information sur le comportement par d�faut quand 'verb' n'est pas sp�cifi�.

Les constantes sont d�finies dans "AutoItConstants.au3".
showflag [optionnel] Le drapeau "mode d'affichage" du programme ex�cut�:
    @SW_HIDE = Fen�tre cach�e
    @SW_MINIMIZE = Fen�tre r�duite
    @SW_MAXIMIZE = Fen�tre maximis�e

Valeur de retour

Succ�s: Retourne le PID du processus qui a �t� lanc�. Ou -1 si il n'y avait pas de PID disponible.
�chec: Retourne 0 et d�finit @error <> 0.

Remarques

Apr�s avoir ex�cut� le programme demand�, le script continue. Pour mettre en pause l'ex�cution du script jusqu'� ce que le programme soit termin�, utilisez la fonction ShellExecuteWait() � la place.

Lorsqu'aucun verbe n'est sp�cifi�, le verbe par d�faut est utilis�. Le verbe par d�faut est le verbe configur� dans le Registre. Si aucun verbe n'est d�fini par d�faut dans le Registre, alors le verbe "open" est utilis�. Si le verbe "open" n'est pas pr�sent, alors le premier verbe inscrit au registre est utilis�.

En relation

Run, RunAs, RunAsWait, RunWait, ShellExecuteWait

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; R�cup�re le fichier texte suivant. Il peut �tre trouv� dans le dossier 'include' dans le chemin d'installation de AutoIt.
    Local $sWow64 = ""
    If @AutoItX64 Then $sWow64 = "\Wow6432Node"
    Local $sFile = RegRead("HKEY_LOCAL_MACHINE\SOFTWARE" & $sWow64 & "\AutoIt v3\AutoIt", "InstallDir") & "\include\_ReadMe_.txt"

    ; Ex�cute le fichier readme (txt) avec l'�diteur utilis� par d�faut pour les fichiers texte sous Windows.
    Local $iPID = ShellExecute($sFile)

    MsgBox($MB_SYSTEMMODAL, "", "PID: " & $iPID)
EndFunc   ;==>Example