DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Exécutables
  • Utilisation en mode Service
  • Lancer l'installation d'un fichier APK
  • Application en arrière-plan : Spécificité à partir de Android 10
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Ouvre directement un document dans son application associée. L'application est tout d'abord ouverte, puis le document spécifié.
Remarques :
  • L'application utilisée pour ouvrir le document est celle associée à l'extension du document dans Windows (fichier INI ou base de registre). Cette application associée peut varier selon les configurations utilisées.
  • WEBDEV - Code Serveur Ce document est ouvert sur le serveur. Cette fonction est utilisable sur le poste de développement, car ce poste fait office de serveur.
  • WEBDEV - Code Navigateur Ce document doit être présent sur le serveur ou à n'importe quelle adresse Internet. Ce document est ouvert sur le poste de l'internaute.
  • Android L'application utilisée pour ouvrir le document est l'application correspondant au type MIME associé à l'extension du fichier. Si plusieurs applications correspondent au même type de fichier, une boîte de dialogue sera affichée pour sélectionner l'application à lancer.
  • iPhone/iPadWidget IOS La fonction LanceAppliAssociée est bloquante : l'application continuera de s'exécuter uniquement à la fermeture du document et de son application associée. Le document doit être présent sur le poste.
  • Pour afficher une page quelconque dans un navigateur, il est également possible d'utiliser la fonction NavigateurLanceAppli.
Exemple
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurEtats et RequêtesCode Utilisateur (MCU)Ajax
// Ouvre le document "Fonctions.doc" dans Word
LanceAppliAssociée("C:\WDNEWS\Version\Fonctions.doc")
// Imprime le document
LanceAppliAssociée("C:\WDNEWS\Version\Fonctions.doc", "print")
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Ouverture d'un site dans le navigateur par défaut
LanceAppliAssociée("http://www.pcsoft.fr")
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Lancement de la messagerie configurée par défaut
LanceAppliAssociée("mailto:pcsoft@pcsoft.fr")
// Lancement de la messagerie avec paramètres
// Paramètres reconnus par Outlook
LanceAppliAssociée("mailto:pcsoft@pcsoft.fr" + ...
"?subject=Sujet : LST &body=Texte : le sommaire de la LST")
WINDEVEtats et RequêtesCode Utilisateur (MCU)
// Ouvre le document "Facture.doc" à partir de son raccourci
LanceAppliAssociée("""C:\Documents and Settings\Julie\Bureau\Raccourci vers Facture.doc.lnk""")
WEBDEV - Code Navigateur
// Ouverture d'un site dans le navigateur en cours
LanceAppliAssociée("http://www.pcsoft.fr")
Syntaxe
<Résultat> = LanceAppliAssociée(<Nom du fichier> [, <Verbe>])
<Résultat> : Booléen
  • Vrai si le document existe et si l'application associée a été lancée.
  • Faux dans le cas contraire.
WEBDEV - Code NavigateurPHP Ce paramètre n'est pas disponible. Cette fonction ne retourne pas de résultat.
Java Renvoie Faux si l'application est exécutée avec une machine virtuelle Java (JRE) inférieure à la version 1.6.
<Nom du fichier> : Chaîne de caractères
Nom et chemin complet (ou relatif) du document à ouvrir. Un chemin de type UNC peut être utilisé.
Si des espaces sont présents dans le nom ou dans le chemin du document à ouvrir, triplez les guillemets encadrant ce paramètre.
WINDEV Ce paramètre peut également correspondre à un raccourci Windows.
AndroidWidget Android Ce paramètre peut correspondre à un chemin de fichier complet, relatif ou à une URI.
Par exemple :
  • "/sdcard/photo.png"
  • "/sdcard/video.3gp".
  • "http://www.pcsoft.fr" : lance le navigateur Web sur la page spécifiée.
  • "geo:1.44951,43.604363" : lance Google Maps ou équivalent.
  • "mailto:pcsoft@pcsoft.fr" lance l'application d'envoi d'emails.
  • "sms:0612345678" : lance l'application d'envoi de SMS.
Les fichiers situés dans le répertoire de l'application ou l'un de ses sous-répertoires ne sont pas accessibles par la plupart des applications externes. Il est conseillé d'utiliser la fonction LanceAppliAssociée avec des fichiers situés sur la mémoire externe de l'appareil (exemple : sdcard) car ils sont accessibles depuis toutes les applications.
<Verbe> : Chaîne de caractères optionnelle
Verbe à utiliser pour lancer le document. Les verbes sont définis par application, pour indiquer les actions pouvant être effectuées. Les verbes les plus courants sont open ou print. Si ce paramètre n'est pas indiqué, le verbe utilisé sera le verbe par défaut pour le type de document.
WEBDEV - Code NavigateurAndroidWidget AndroidiPhone/iPadWidget IOSJavaPHP Ce paramètre n'est pas disponible.
Remarques

Utilisation en mode Service

La fonction LanceAppliAssociée utilisée en mode service permet bien de lancer l'application associée, mais l'interface de cette application n'est pas visible.
Android

Lancer l'installation d'un fichier APK

A partir d'Android 8, pour lancer l'installation d'un fichier APK avec la fonction LanceAppliAssociée, il est nécessaire de modifier les permissions requises par l'application.
Permission requise : REQUEST_INSTALL_PACKAGES.
Cette permission permet d'installer des packages.
Pour plus de détails (notamment pour les versions précédentes de WINDEV Mobile), consultez FAQ 16927 : Que faire sous Android 8 si l'installation d'un APK avec la fonction LanceAppliAssociée n'est plus autorisée ?.
AndroidWidget Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction LanceAppliAssociée peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Classification Métier / UI : Code neutre
Composante : wd300std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Ouverture site tiers à partir d'un code Webdev serveur
Pour ouvrir un site tiers sur le poste de l'utilisateur final à partir d'un code serveur en Webdev, il est nécessaire d'utiliser la fonction 'ScriptAffiche'.
En effet, la fonction 'LanceAppliAssociée', en code serveur Webdev, fonctionnera sur le poste de développement comme précisé dans les remarques en haut de page, mais une fois déployé, n'ouvrira rien à l'utilisateur final.
Pour ma part, ça m'est indispensable dans mes développements afin d'ouvrir un nouvel onglet à l'utilisateur final, en passant des variables en paramètres du site à ouvrir, ce qui permet une interconnexion complète de mes différents projets déployés.
Yoann
26 oct. 2023

Dernière modification : 13/09/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale