EmailOuvreMessagerie (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

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

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

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.
sur le téléphone.

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

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 :

Envoi d'une page au serveur (fonction PageValide).
Ouverture du logiciel de messagerie (fonction EmailOuvreMessagerie).

Seule la dernière action (ouverture de la messagerie) sera effectuée.

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

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.

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

Liste des exemples associés :

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 : wd300com.dll

Voir Aussi

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