AP ShellExecute

version 6.8.2

AP ShellExecute (nomFichier{; mode{; param}}) Entier long

La commande AP ShellExecute permet de lancer une application ou d'ouvrir un document depuis une base 4D.

Note : Cette commande est similaire à la commande AP Sublaunch, toutefois son fonctionnement a été optimisé sous Windows, notamment via l'utilisation du 3e paramètre.

Vous devez passer 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.

Note : Le paramètre param est utilisé sous Windows uniquement. Il est ignoré sous Mac OS.

Vous devez passer 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, Mac OS se chargera d'exécuter l'application associée.

Le paramètre mode vous permet de spécifier un ouverture synchrone (si vous passez 1) ou asynchrone (si vous passez 0) de l'application ou du document.

(1) Cet exemple ouvre un document de type Word® se trouvant à la racine du disque principal :

      `Sous Windows
   $err:=AP ShellExecute ("C:\Test.doc")
      `Sous Mac OS
   $err:=AP ShellExecute ("DisqueDur: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 (Windows) 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")

AP Sublaunch.