PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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.
  • Versions 18 et supérieures
    de l'utilisateur sur le poste Windows en cours.
    Nouveauté 18
    de l'utilisateur sur le poste Windows en cours.
    de l'utilisateur sur le poste Windows en cours.
  • Versions 17 et supérieures
    AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App sur le téléphone.
    Nouveauté 17
    AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App sur le téléphone.
    AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App sur le téléphone.
AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App 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, ...).
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
Universal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Versions 19 et supérieures
WINDEVWindows Cette fonction est désormais disponible pour les applications WINDEV sous Windows.
Nouveauté 19
WINDEVWindows Cette fonction est désormais disponible pour les applications WINDEV sous Windows.
WINDEVWindows Cette fonction est désormais disponible pour les applications WINDEV sous Windows.
Versions 21 et supérieures
WINDEVUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
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 avec guillemets
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 avec guillemets
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".
Versions 17 et supérieures

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.
  • AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App 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.
Nouveauté 17

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.
  • AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App 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.

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.
  • AndroidWidget AndroidiPhone/iPadUniversal Windows 10 App 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.
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 : wd240com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire