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