LanceAppliAssociée (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Exécutables

Utilisation en mode Service
Fonctionnalité d'application requise
Lancer l'installation d'un fichier APK
Application en arrière-plan : Spécificité à partir de Android 10

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

LanceAppliAssociée (Fonction)

En anglais : ShellExecute

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.
Ce document est ouvert sur le serveur. Cette fonction est utilisable sur le poste de développement, car ce poste fait office de serveur.
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.
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.
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

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

// Ouverture d'un site dans le navigateur par défaut
LanceAppliAssociée("http://www.pcsoft.fr")

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

// Ouvre le document "Facture.doc" à partir de son raccourci
LanceAppliAssociée("""C:\Documents and Settings\Julie\Bureau\Raccourci vers Facture.doc.lnk""")

// 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.
Ce paramètre n'est pas disponible. Cette fonction ne retourne pas de résultat.
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.
Ce paramètre peut également correspondre à un raccourci Windows.
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.
Seuls les fichiers présents dans le répertoire "appdata" peuvent être manipulés. Il n'est pas possible de spécifier une URL Internet.

<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.

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.

Fonctionnalité d'application requise

L'utilisation de cette fonction entraîne la déclaration d'une fonctionnalité d'application dans l'assistant de génération de l'application.

Fonctionnalité requise : Réseaux domestiques et professionnels

Cette fonctionnalité permet aux applications d'utiliser des accès entrants et sortants vers des réseaux domestiques et professionnels.

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 ?.

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.

Pour plus de détails, consultez Android 10 : Comportement des applications en arrière-plan.

Classification Métier / UI : Code neutre

Composante : wd300std.dll

Voir Aussi

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 : 24/03/2023

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