PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • Action de la fonction EmailOuvreMessagerie
  • Dans quel code utiliser la fonction EmailOuvreMessagerie ?
  • Cas particuliers
  • Application en arrière-plan : Spécificité Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal 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/iPadWidget iOSCatalystUniversal Windows 10 App sur le téléphone.
    Nouveauté 17
    AndroidWidget AndroidiPhone/iPadWidget iOSCatalystUniversal Windows 10 App sur le téléphone.
    AndroidWidget AndroidiPhone/iPadWidget iOSCatalystUniversal Windows 10 App sur le téléphone.
AndroidWidget AndroidiPhone/iPadWidget iOSCatalystUniversal 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/iPadWidget iOSCatalystUniversal 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/iPadWidget iOSCatalystUniversal 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/iPadWidget iOSCatalystUniversal 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.
Versions 25 et supérieures
AndroidWidget Android

Application en arrière-plan : Spécificité 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.
Nouveauté 25
AndroidWidget Android

Application en arrière-plan : Spécificité 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.
AndroidWidget Android

Application en arrière-plan : Spécificité 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 :
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 : wd260com.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire