Formation 4D Pack Help, tutoriel & guide de travaux pratiques en pdf.
Note de compatibilité :
Cette commande est désormais obsolète, elle est conservée pour des raisons de compatibilité uniquement et sera supprimée dans les prochaines versions du plug-in. Il est fortement recommandé d’utiliser la commande LANCER PROCESS EXTERNE de 4D. A noter que depuis la version 11.0 de 4D, AP ShellExecute ne fonctionne plus que sous Windows.
AP ShellExecute (nomFichier{; mode{; param}}) → Entier long
Paramètre Type Description nomFichier Chaîne → Nom du fichier ou du document à exécuter mode Entier long → Etat de la fenêtre à l’ouverture param Texte → Paramètres de l’application
Résultat Entier long ← 0 si l’exécution de la commande est correcte, sinon code d’erreur.
Note : Cette commande fonctionne uniquement sous Windows. Sous Mac OS, elle est inopérante.
Description La commande AP ShellExecute permet de lancer une application ou d’ouvrir un document depuis une base 4D.
Passez dans le paramètre nomFichier le nom ou le chemin d’accès complet (absolu) du fichier à lancer. Il est possible de passer uniquement un nom de fichier ou un chemin d’accès relatif lorsque l’application ou le document à ouvrir se trouve à côté de la structure de la base. Vous pouvez indiquer un nom de document, Windows se chargera d’exécuter l’application associée.
Le paramètre mode permet de spécifier le mode d’apparition de la fenêtre dans laquelle l’application sera lancée : • si vous passez 0, la fenêtre apparaîtra normalement ; • si vous passez 1, la fenêtre sera en plein écran ; • si vous passez 2, la fenêtre sera réduite et apparaîtra dans la barre des tâches de Windows.
Le paramètre param vous permet de passer tout type de paramètre supplémentaire attendu par l’application exécutée. Par exemple, si vous utilisez cette commande pour lancer un navigateur Web, vous pouvez passer dans ce paramètre un URL spécifique.
4D Pack – Guide de référence 39
Exemples (1) Cet exemple ouvre un document de type Word® se trouvant à la racine du disque principal : `Sous Windows $err:=AP ShellExecute (« C:\Test.doc »)
(2) Cet exemple lance le navigateur Internet par défaut en plein écran sur le site de 4D : $err:=AP ShellExecute (« www.4d.fr »; »1″)
(3) Cet exemple ouvre le site de 4D en plein écran sur Netscape® quel que soit le navigateur Internet par défaut : $err:=AP ShellExecute (« C:\Program Files\Netscape\NETSCAPE.EXE »; »1″; »www.4d.fr »)
(4) Cet exemple ouvre l’Explorateur Windows dans une fenêtre normale et affiche le contenu du dossier Music : $err:=AP ShellExecute (« C:\WINDOWS\explorer.exe »;0; »C:\Music »)