|
|
|
|
|
|
|
|
|
|
- Propriétés spécifiques à la description des variables de type notificationAction
- Divers
notificationAction (Type de variable) En anglais : notificationAction
Les notifications (décrites par une variable de type Notification) ont une action par défaut qui s'exécute lorsque l'utilisateur clique sur la notification. Cette action est définie par la propriété ActionClic du type Notification. Il est possible d'associer des actions supplémentaires à une notification (propriété ActionSupplémentaire). Ces actions se présentent sous la forme de texte situés en dessous du message de la notification. Remarques : - Lorsque la notification est affichée sur un objet connecté comme une montre (Android Wear), les actions supplémentaires sont accessibles par un mouvement de balayage vers la gauche sur l'écran.
Dans ce cas, chaque action supplémentaire est affichée sur la totalité de l'écran. - Sur un téléphone ou une tablette, les boutons correspondant aux actions supplémentaires ne sont visibles que lorsque la notification est déroulée. Les notifications affichées sont automatiquement enroulées ou déroulées par le système en fonction de la place disponible dans la liste. L'utilisateur a toutefois la possibilité d'enrouler ou dérouler une notification en effectuant un geste de balayage vers le haut (enrouler) ou vers le bas (dérouler) à l'aide de deux doigts.
- Si la notification est affichée sur un appareil en version inférieure à Android 4.1, les actions supplémentaires seront ignorées.
- Selon le système et le périphérique utilisé, l'affichage des notification peut varier.
Le type notificationAction permet de définir toutes les caractéristiques avancées d'une action supplémentaire associée à une notification. Les caractéristiques de cette action supplémentaire peuvent être définies et modifiées à l'aide de différentes propriétés WLangage. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable. n est une Notification
n.Titre = "Nouveau message"
n.Message = "Commande n°54781-4551"
n.MessageSecondaire = "client@societe.com"
n.GrandeIcone = "enveloppe.png"
n.ActionSupplémentaire[1].LibelléAction = "Répondre"
n.ActionSupplémentaire[1].Icone = "repondre.png"
n.ActionSupplémentaire[1].ActionClic = "procRepondre"
n.ActionSupplémentaire[2].LibelléAction = "Supprimer"
n.ActionSupplémentaire[2].Icone = "supprimer.png"
n.ActionSupplémentaire[2].ActionClic = "procSupprimer"
NotifAjoute(n)
// Notification avec demande de réponse pour les objets connectés
n est une Notification
n.Titre = "Nouveau message"
n.Message = "Commande n°54781-4551"
n.MessageSecondaire = "client@societe.com"
n.GrandeIcone = "enveloppe.png"
n.ActionSupplémentaire[1].LibelléAction = "Répondre"
n.ActionSupplémentaire[1].Icone = "repondre.png"
n.ActionSupplémentaire[1].ActionClic = "procRepondre"
n.ActionSupplémentaire[1].ChoixRéponse = notifRéponseLibre + RC + "Merci pour votre commande"
n.ActionSupplémentaire[1].LibelléQuestion = "Quelle est votre réponse ?"
n.ActionSupplémentaire[2].LibelléAction = "Supprimer"
n.ActionSupplémentaire[2].Icone = "supprimer.png"
n.ActionSupplémentaire[2].ActionClic = "procSupprimer"
NotifAjoute(n)
PROCÉDURE procRépondre(n est une Notification, sReponse est une chaîne)
Email.Sujet = "RE : " + n.Message
Email.Destinataire[1] = n.MessageSecondaire
Email.NbDestinataire = 1
SI sReponse <> "" ALORS
Email.Message = sReponse
FIN
EmailLanceAppli()
Remarques Propriétés spécifiques à la description des variables de type notificationAction Les propriétés suivantes peuvent être utilisées pour manipuler une action supplémentaire : | | | | Nom de la propriété | Type manipulé | Effet |
|---|
| ActionClic | Valeur ou Nom de procédure | Nom de la procédure WLangage appelée lorsque l'utilisateur clique sur le bouton correspondant à l'action. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Notification>, <Réponse>) où : - <Notification> est une variable de type Notification correspondant à la notification associée à l'action sélectionnée.
Si la procédure WLangage retourne Vrai ou ne retourne pas de valeur, la notification sera automatiquement supprimée de la barre système.
Si la procédure retourne Faux, la notification restera affichée.
Si la valeur de la propriété ActionClic vaut chaîne vide (""), aucune action ne sera effectuée lors du clic et la notification sera automatiquement effacée après le clic. - <Réponse> est une chaîne de caractère renseignée avec la réponse donnée par l'utilisateur si les conditions suivantes sont remplies :
- l'action a été exécutée depuis un objet connecté,
- la propriété ChoixRéponse a été renseignée.
Dans le cas contraire, <Réponse> vaut chaîne vide ("").
Remarque : Il est conseillé d'utiliser des procédures globales. Si la procédure est une procédure locale, il est nécessaire de préfixer le nom de cette procédure par le nom complet de l'objet auquel appartient la procédure. Par exemple, pour une procédure locale de fenêtre : "FEN_Fenêtre1.MaProcedure". | | ChoixRéponse | Chaîne de caractères | Correspond aux différentes réponses prédéfinies à proposer à l'utilisateur sur du clic sur l'action. Les réponses doivent être séparées par un Retour Chariot (RC). Pour autoriser l'utilisateur à saisir une réponse libre, utilisez la constante notifRéponseLibre. Cette constante peut être combinée avec une ou plusieurs réponses prédéfinies. Remarque : Le choix des réponses n'est proposé à l'utilisateur que lorsque l'action est exécutée depuis un objet connecté fonctionnant sous Android Wear. Si l'action est exécutée depuis un téléphone ou une tablette, la procédure spécifiée dans la propriété ActionClic sera directement appelée. | | Icone | Chaîne de caractères | Chemin de l'icône représentant l'action. A partir d'Android 7.0, cette propriété n'est plus utilisée : les icônes des actions des notifications ne sont plus affichées. | | LibelléAction | Chaîne de caractères | Libellé décrivant l'action à effectuer. Cette propriété est obligatoire : l'action sera ignorée si aucun libellé n'est associé à l'action. | | LibelléQuestion | Chaîne de caractères | Libellé du message affiché pour demander une réponse à l'utilisateur. Ce libellé est utilisé lorsque la propriété ChoixRéponse a été renseignée. Si cette propriété n'est pas renseignée, un message système sera affiché. |
Divers Pour réinitialiser le contenu d'une variable de type notificationAction, il est possible d'utiliser la fonction VariableRAZ. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|