Functions > Process >


ShellExecuteWait

Ex�cute un programme externe en utilisant l'API ShellExecute et interrompt l'ex�cution du script jusqu'� ce qu'il se termine.

ShellExecuteWait ( "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 flag "show" 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 code de sortie du programme qui a �t� ex�cut�.
�chec: D�finit @error <> 0.

Remarques

Apr�s avoir ex�cut� le programme demand� le script s'interrompt jusqu'� ce que le programme demand� termine

Lorsqu'aucun verbe n'est sp�cifi�, un verbe est utilis� par d�faut. 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, ShellExecute

Exemple

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Ex�cute le Bloc-notes et attend que le processus du Bloc-notes se termine.
    Local $iReturn = ShellExecuteWait("notepad.exe")

    ; Affiche le code de retour du processus du Bloc-notes.
    MsgBox($MB_SYSTEMMODAL, "", "Le code de retour de Notepad �tait: " & $iReturn)
EndFunc   ;==>Example