DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions de gestion du navigateur
  • Action de la fonction EmailOuvreMessagerie
  • Dans quel code utiliser la fonction EmailOuvreMessagerie ?
  • Cas particuliers
  • Application en arrière-plan : Spécificité à partir de Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
EmailOuvreMessagerie (Fonction)
En anglais : EmailOpenMail
Ouvre le logiciel de messagerie par défaut :
  • de l'internaute sur le poste navigateur.
  • de l'utilisateur sur le poste Windows en cours.
  • Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst sur le téléphone.
Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Remarque : La fonction EmailLanceAppli permet également d'ouvrir directement le logiciel de messagerie du téléphone. Il est conseillé d'utiliser la fonction EmailLanceAppli (pour la gestion des pièces jointes, les envois multi-destinataires, ...).
Exemple
// Ouvre le logiciel de messagerie
EmailOuvreMessagerie()
// Ouvre le logiciel en spécifiant l'email destinataire
// le sujet et le texte de l'email
EmailOuvreMessagerie("pcsoft@pcsoft.fr", "Sujet: LST", "Texte: Le sommaire de la LST")
Syntaxe
EmailOuvreMessagerie([<Adresse email> [, <Sujet de l'email> [, <Corps du message>]]])
<Adresse email> : Chaîne de caractères optionnelle
Adresse email du destinataire. Cette adresse sera affichée dans la fenêtre du logiciel de messagerie.
<Sujet de l'email> : Chaîne de caractères optionnelle
Sujet de l'email qui sera affiché dans la fenêtre du logiciel de messagerie.
<Corps du message> : Chaîne de caractères optionnelle avec guillemets
Texte du message. Les caractères non alphanumériques sont automatiquement convertis pour permettre le passage des caractères spéciaux (retours chariots, les tabulations, ...).
Remarques
WEBDEV - Code Navigateur

Action de la fonction EmailOuvreMessagerie

La fonction EmailOuvreMessagerie provoque une action sur la page affichée dans le navigateur de l'internaute. Or les navigateurs Internet autorisent uniquement une seule action sur la page par traitement.
Par exemple, si un traitement effectue les actions suivantes :
  1. Envoi d'une page au serveur (fonction PageValide).
  2. Ouverture du logiciel de messagerie (fonction EmailOuvreMessagerie).
Seule la dernière action (ouverture de la messagerie) sera effectuée.
WEBDEV - Code Navigateur

Dans quel code utiliser la fonction EmailOuvreMessagerie ?

En WEBDEV, certains types de bouton provoquent automatiquement une action sur la page :
  • bouton de type "envoi au serveur",
  • bouton de type "autre" dont l'action est différente de "aucune".
Si la fonction EmailOuvreMessagerie est utilisée dans le traitement de clic navigateur de ces boutons (ou dans une procédure appelée par ce traitement), cette fonction sera ignorée : seule l'action du bouton sera effectuée.
Conséquences : La fonction EmailOuvreMessagerie ne peut pas être utilisée dans un code provoquant (automatiquement ou non) une action. Cette fonction est ignorée :
  • dans le code de clic d'un bouton de type "envoi au serveur".
  • dans le code de clic d'un bouton de type "autre" dont l'action est différente de "aucune".
  • si elle est suivie de la fonction PageValide ou de la fonction EmailOuvreMessagerie (dans le traitement en cours, dans une procédure appelée par le traitement en cours, ou dans un autre traitement appelé par la fonction Exécute).
Pour utiliser la fonction EmailOuvreMessagerie depuis un bouton (code de clic navigateur du bouton), ce bouton doit avoir les caractéristiques suivantes :
  • type du bouton : "Autre".
  • action : "Aucune".

Cas particuliers

  • Si aucune application d'envoi d'emails n'est trouvée sur l'appareil, une erreur non fatale est déclenchée. Pour savoir si le lancement de l'application d'envoi d'emails a échoué, utilisez la variable ErreurDétectée.
  • Universal Windows 10 AppAndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst La fonction EmailOuvreMessagerie peut être utilisée dans l'émulateur. Elle ne peut pas être utilisée dans le simulateur.
  • La fonction EmailOuvreMessagerie n'est pas bloquante. Le code suivant l'appel de cette fonction continuera de s'exécuter dès que l'application d'envoi d'emails aura été lancée.
  • Il n'est pas possible de savoir si l'utilisateur a validé l'envoi de l'email.
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 EmailOuvreMessagerie 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.
Liste des exemples associés :
WM Gestion Contacts Exemples multiplateforme (WINDEV Mobile) : WM Gestion Contacts
[ + ] Cet exemple illustre la gestion de contacts pour Android et iOS.
Il permet de :
- lister les contacts du téléphone
- appeler les contacts
- envoyer des sms aux contacts
- ...
Composante : wd290com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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