AP ShellExecute

4D - Documentation   Français   English   German   4D_Pack, Commandes par thèmes   4D_Pack, Index des commandes   Retour   Précédent   Suivant

version 11 (Modifiée)


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ètreTypeDescription
nomFichierChaîneNom du fichier ou du document à exécuter
modeEntier longEtat de la fenêtre à l'ouverture
paramTexteParamètres de l'application
RésultatEntier long0 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.

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")

Référence

LANCER PROCESS EXTERNE.


4D - Documentation   Français   English   German   4D_Pack, Commandes par thèmes   4D_Pack, Index des commandes   Retour   Précédent   Suivant