Le Centre W..D..

Meilleure résolution
mode 800 x 600

Optimisé pour
IE v.5
Netscape v.6
mais surtout pour
Mozilla v.1
minimum

Membre de Click-FR®, Réseau francophone Paie-Par-Click

ShellExecute

Date de parution : 08/02/2000 - Cette fiche API a été lue 2192 fois

Description

ShellExecute permet d'ouvrir, d'imprimer ou de lancer un programme. En cas d'échec la fonction retourne 0.

Les codes d'erreur sont les suivants.

ERROR_FILE_NOT_FOUND = 2	Le fichier spécifié est introuvable.
ERROR_PATH_NOT_FOUND = 3	Le répertoire spécifié est introuvable.
ERROR_BAD_FORMAT = 11	Le programme spécifié n'est pas valide.
SE_ERR_ACCESSDENIED = 5	Win 95/98 seulement : Windows refuse l'accès au fichier spécifié.
SE_ERR_ASSOCINCOMPLETE = 27	L'association du fichier est incomplète ou invalide.
SE_ERR_DDEBUSY = 30	Echec de la transaction DDE car d'autres transactions sont en cours et occupe le système.
SE_ERR_DDEFAIL = 29	Echec de la transaction DDE.
SE_ERR_DDETIMEOUT = 28	La transaction DDE n'a pu aboutir car le délai est trop long.
SE_ERR_DLLNOTFOUND = 32	Win 95/98 seulement : La DLL spécifiée n'est pas trouvée.
SE_ERR_FNF = 2	Idem à ERROR_FILE_NOT_FOUND.
SE_ERR_NOASSOC = 31	Pas de programme associé pour ce fichier
SE_ERR_OOM = 8	Win 95/98 seulement : Problème de mémoire pour terminer l'opération..
SE_ERR_PNF = 3	Idem à ERROR_PATH_NOT_FOUND.
SE_ERR_SHARE = 26	Violation de partage rencontrée.

Syntaxe

AppelDLL32("shell32", "ShellExecuteA", hwnd, &lpOperation, &lpFile, &lpParameters, &lpDirectory, nShowCmd)

hWnd

Handle de la fenêtre qui appelle la fonction.

lpOperation

Nom de l'opération à effectuer. "open" pour ouvrir le fichier ou lancer son programme associé. "print" pour imprimer le document. Sous Win 95/98, "explore" pour ouvrir le répertoire dans une fenêtre de l'Explorateur. Par défaut, nom de l'opération est "open".

lpFile

Nom du fichier à lancer.

lpParameters

Paramètres à passer à l'application.

lpDirectory

Répertoire de travail de l'opération.

nShowCmd

Comment afficher la fenêtre que la fonction ouvre :

SW_HIDE = 0	Cacher la fenêtre.
SW_MAXIMIZE = 3	Maximiser la fenêtre.
SW_MINIMIZE = 6	Minimiser ou réduire la fenêtre.
SW_RESTORE = 9	Restaurer la fenêtre.
SW_SHOW = 5	Montrer la fenêtre.
SW_SHOWMAXIMIZED = 3	Montrer la fenêtre dans son état maximal.
SW_SHOWMINIMIZED = 2	Montrer la fenêtre dans son état minimal.
SW_SHOWMINNOACTIVE = 7	Montrer la fenêtre en état minimal et sans l'activer.
SW_SHOWNA = 8	Montrer la fenêtre dans son état actuel mais sans l'activer.
SW_SHOWNOACTIVATE = 4	Montrer la fenêtre dans sa taille et à sa position la plus récente mais sans l'activer
SW_SHOWNORMAL = 1	Montrer la fenêtre et l'activer (comme tel)

Compatibilité

Toutes versions

Remarque

Cette fonction figure au W-Langage à partir de la version 5.

Exemple 1

// Cette procédure permet de lancer l'application associée // au fichier demandé


PROCEDURE LanceAppliAssociee(NomFichier)
hWnd est entier long //Handle fenêtre

lpOperation est une chaine asciiz sur 200 = "open"

lpFile est une chaine asciiz sur 200 = NomFichier

lpParameters est une chaine asciiz sur 200 = Null

lpDirectory est une chaine asciiz sur 200 = Null

nShowCmd est un entier = 1
hWnd = Handle() //Récupère le handle

// Ce code vous est offert par Beaussier en ligne
AppelDll32("Shell32", 
"ShellExecuteA", hWnd, &lpOperation,...
&lpFile, &lpParameters, &lpDirectory, nShowCmd)

Nombre de commentaire sur ShellExecute : 0

Rappel : Le code fourni est compatible Windev v.4 et 5. Pour les versions supérieures, vous devez modifier le type des variables numériques. Par exemple : entier long devient entier.
Bien sûr, les marques citées sont déposées par leurs sociétés respectives. Ces pages sont à la disposition de tous, le code fourni est libre mais toute responsabilité est déclinée en cas de mauvais usage ou de dysfonctionnement.
© 2000-2005 Beaussier & Le Centre W..D..