PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

PV


  • Utilisation du type Notification
  • Exemple de notification sous Android
  • Propriétés spécifiques à la description des variables de type Notification pour une notification locale
  • Propriétés spécifiques à la description des variables de type Notification pour une notification push
  • Fonctions utilisant le type Notification
  • Réinitialisation
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
Le type Notification permet de manipuler
  • AndroidiPhone/iPadWidget IOS les notifications locales.
  • les notifications en push.
Les caractéristiques de cette notification 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.
Exemple
// Notification simple
// --------------------
notif est une Notification
notif.Titre = "Nouveau message reçu"
notif.Message = "Cliquez pour afficher le message"
NotifAjoute(notif)
Android
// Notification avec deux actions supplémentaires
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 définition d'un format de notification
n est une Notification
n.Titre = "Photo enregistrée"
n.Message = "Date de la prise de vue : 18/07/2014 19:45"
n.GrandeIcone = "photo.png"
n.MessageSecondaire = "desert.png"
n.Format.Format  = notifFormatImage
n.Format.Contenu = fRepEnCours + "photos/desert.png"
NotifAjoute(n)
Remarques

Utilisation du type Notification

Le type Notification est utilisé pour la gestion des notifications locales et pour la gestion des notifications push.
Cette page d'aide présente :

Exemple de notification sous Android

Les différents éléments de cette notification sont configurables grâce au type Notification :
  • 1. Grande icône de la notification (propriété GrandeIcone).
  • 2. Titre de la notification (propriété Titre).
  • 3. Message de la notification (propriété Message).
  • 4. Message secondaire (propriété MessageSecondaire).
  • 5. Heure de réception de la notification (propriété Chronomètre).
  • 6. Icône de l'application (propriété Icone).
  • 7. Actions supplémentaires de la notification (propriété ActionSupplémentaire).
AndroidiPhone/iPadWidget IOS

Propriétés spécifiques à la description des variables de type Notification pour une notification locale

Les propriétés suivantes peuvent être utilisées pour manipuler une notification :
Nom de la propriétéType manipuléEffet
ActionClicValeur ou nom de procédureNom de la procédure WLangage appelée lorsque l'utilisateur clique sur la notification dans la liste déroulante des notifications affichée sur l'appareil.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Notification>)
où <Notification> est une variable de type Notification correspondant à la notification sélectionnée par l'utilisateur.
Si la procédure WLangage retourne Vrai ou ne retourne pas de valeur :
  • Android la notification sera automatiquement supprimée de la barre système.
  • iPhone/iPadWidget IOS la notification n'est pas supprimée de la barre système.
Si la procédure retourne Faux, la notification restera affichée.
Si 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.
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 la nom complet de l'objet auquel appartient la procédure. Par exemple, pour une procédure locale de fenêtre : "FEN_Fenêtre1.MaProcedure".
ActionSupplémentaireTableau de variables de type notificationActionActions supplémentaires associées à la notification.
Attention : Les actions supplémentaires des notifications sont disponibles uniquement à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, les actions supplémentaires seront ignorées.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
ActiveApplicationBooléen
  • Vrai si l'application doit être mise au premier plan lors du clic sur la notification.
  • Faux (valeur par défaut) dans le cas contraire.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
AffichageLEDBooléen
  • Vrai si la LED de l'appareil doit être allumée lors de l'affichage de la notification,
  • Faux (valeur par défaut) dans le cas contraire.
La couleur et la fréquence d'allumage de la LED peuvent varier d'un appareil à l'autre.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
AlerteUneFoisBooléenPermet de gérer l'alerte dans le cas où la notification est déjà affichée :
  • Vrai pour ne pas jouer le son ou la vibration de la notification si la notification est déjà affichée,
  • Faux (valeur par défaut) dans le cas contraire.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
BadgeEntierNuméro affiché par l'icône de l'application.
Android Cette propriété est supportée sous Android à partir de Android 8.0.
CatégorienotificationCatégorieCatégorie associée à la notification. Les catégories de notification sont disponibles à partir d'Android 8.0 (API level 26). Si l'application s'exécute sur une version plus ancienne la propriété Catégorie sera ignorée.
Il est conseillé de toujours associer une catégorie à une notification
  • Si la catégorie n'existe pas au moment de l'ajout de la notification, elle sera automatiquement créée,
  • Si la catégorie existe déjà pour l'application, la notification sera associée à la catégorie existante.
  • Si aucune catégorie n'a été spécifiée, la notification sera automatiquement associée à une catégorie prédéfinie en fonction de son niveau de priorité. Les catégories prédéfinies sont les suivantes :
    • Priorité min.
    • Priorité faible
    • Priorité normale
    • Priorité élevée
    • Priorité max.
    La catégorie prédéfinie sera créée lors du premier ajout d'une notification sans catégorie avec le niveau de priorité correspondant et utilisera les paramètres visuels et auditifs de cette notification (vibreur, son, led, ...). Ces paramètres pourront ensuite être modifiés par l'utilisateur final. Si la catégorie prédéfinie existe déjà, la notification héritera des propriétés de cette catégorie.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
ChronomètreBooléen
  • Vrai pour afficher un chronomètre à la place de l'heure de la notification. Le chronomètre démarrera automatiquement lors de la réception de la notification et son affichage sera mis à jour automatiquement.
  • Faux (valeur par défaut) pour ne pas afficher de chronomètre. L'heure associée à la notification sera affichée.
Attention : L'affichage d'un chronomètre dans les notifications est disponible à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le chronomètre sera ignoré et l'heure associée à la notification sera affichée.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
ContenuChaîne de caractèresDonnées personnalisées de la notification. Ces données ne sont pas affichées dans la notification.
CouleurLEDEntierCouleur de la LED lors de l'affichage de la notification.
La valeur de cette propriété est prise en compte uniquement si la propriété AffichageLED vaut Vrai.
Par défaut, la couleur d'affichage de la LED est verte.
Cette couleur peut correspondre à :
Attention : Certains appareils ne permettent pas de modifier la couleur de la LED ou ne proposent que certaines couleurs. Si la couleur spécifiée n'est pas supportée par l'appareil, une couleur par défaut sera utilisée.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
DateHeureActivationDateHeure ou chaîne de caractèresDate et heure auxquelles la notification doit être envoyée. Par défaut, la notification est envoyée immédiatement.
Android Cette propriété n'est pas disponible.
FormatnotificationFormatFormat d'affichage de la notification lorsque celle-ci est déroulée.
Attention : L'affichage des notifications en mode "déroulé" est disponible uniquement à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le format d'affichage sera ignoré.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
GrandeIconeChaîne de caractèresChemin de l'image correspondant à la grande icône associée à la notification. Cette icône sera affichée à gauche du titre et du message de la notification.
Si aucune image n'est spécifiée, l'icône spécifiée par la propriété Icone sera utilisée. Si cette dernière n'est pas spécifiée, l'icône de l'application sera utilisée.
Attention : L'affichage de cette image dans les notifications est possible uniquement à partir de Android 3.0 (Honeycomb, api level 11). Sur des appareils en version inférieure, cette image sera ignorée.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
IconeChaîne de caractèresChemin de l'image correspondant à l'icône associée à la notification.
Si aucune icône n'est spécifiée, l'icône de l'application sera utilisée.
iPhone/iPadWidget IOS Remarques :
  • Le fichier utilisé doit être dans le bundle de l'application. Le chemin spécifié doit être un chemin relatif.
  • L'image sera affichée uniquement si l'application n'est pas au premier plan (c'est-à-dire si l'application n'est pas active).
LibelléActionChaîne de caractèresLibellé du bouton d'action de la notification.
Android Cette propriété n'est pas disponible.
LocaleBooléen
  • Vrai si la notification est locale à l'appareil qui la reçoit : cette notification ne doit pas être transmise aux objets fonctionnant sous Android Wear connectés à l'appareil (par exemple, une montre).
  • Faux (valeur par défaut) si la notification doit être transmise automatiquement aux objets connectés.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
MaxJaugeEntierValeur maximale de la jauge affichée dans la notification.
La valeur sera prise en compte uniquement si la propriété TypeJauge correspond à la constante notifJaugeStandard.
Cette fonctionnalité est disponible à partir de Android 3.0.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
MessageChaîne de caractèresMessage de la notification.
MessageSecondaireChaîne de caractèresMessage secondaire affiché en dessous du message principal de la notification.
Attention : L'affichage d'un message secondaire dans les notifications est disponible à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le message secondaire sera ignoré.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
PrioritéConstante de type EntierPriorité de la notification.
Le changement de priorité d'une notification permet de modifier sa position d'affichage dans la liste des notifications de l'appareil afin que l'utilisateur puisse voir les notifications les plus importantes en premier. Une notification avec une priorité élevée sera affichée au début de la liste alors qu'une notification avec une priorité faible sera affichée en fin de liste.
Dans certaines situations, une notification avec une priorité faible peut être masquée à l'utilisateur si d'autres notifications avec des priorités plus élevées sont reçues.
Cette propriété peut prendre les valeurs suivantes :
  • notifPrioritéMax : priorité maximale (exemple : appel entrant).
  • notifPrioritéElévée : priorité élevée (exemple : réception d'un email urgent).
  • notifPrioritéDéfaut (valeur par défaut) : priorité normale (exemple : réception d'un SMS).
  • notifPrioritéFaible : priorité faible (exemple : notification de mise à jour).
  • notifPrioritéMin : priorité minimale (exemple : information commerciale).
La modification des priorités des notifications est possible uniquement à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, la priorité sera ignorée : toutes les notifications ont la même priorité.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
SonChaîne de caractèresChemin du fichier son à jouer lors de l'affichage de la notification.
Pour jouer le son par défaut des notifications, utilisez la constante notifSonDéfaut. Ce son par défaut peut varier d'un appareil à l'autre.
Il est possible de jouer un son issu d'un fichier audio intégré à l'application (via l'assistant de génération) : il suffit d'indiquer le nom de fichier et son extension.
Pour ne pas associer de son à la notification, utilisez la valeur chaîne vide ("", valeur par défaut).
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Remarques :
  • Le fichier utilisé doit être dans le bundle de l'application. Le chemin spécifié doit être un chemin relatif.
  • Le fichier utilisé doit être au format "aac" et sa durée ne doit pas dépasser 30 secondes.
  • Le son sera joué uniquement si l'application n'est pas au premier plan (c'est-à-dire si l'application n'est pas active).
SupprimableBooléen
  • Vrai (valeur par défaut) si la notification peut être supprimée par l'utilisateur,
  • Faux dans le cas contraire.
Si cette propriété vaut Faux, la notification sera effacée uniquement dans les cas suivants :
  • Fermeture de l'application.
  • Appel de la fonction NotifSupprime.
  • Si la procédure WLangage exécutée lors du clic (propriété ActionClic) a retourné Vrai ou n'a pas retourné de valeur.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
TexteDéroulantChaîne de caractèresTexte déroulant affiché furtivement dans la barre système lors de l'affichage de la notification.
Si cette propriété vaut chaîne vide ("", valeur par défaut), aucun message ne sera affiché.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
TitreChaîne de caractèresTitre de la notification.
Si aucun titre n'est spécifié, le nom de l'application sera utilisé.
TypeJaugeConstante de type EntierType de jauge affichée dans la notification :
  • notifJaugeInfinie : une jauge infinie sera affichée dans la notification.
  • notifJaugeSans (valeur par défaut) : aucune jauge ne sera affichée dans la notification.
  • notifJaugeStandard : une jauge standard sera affichée dans la notification. La valeur et la borne de cette jauge peuvent être fixées respectivement par les propriétés .MaxJauge et .ValeurJauge.
Cette fonctionnalité est disponible à partir de Android 3.0.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
ValeurJaugeEntierValeur courante de la jauge affichée dans la notification.
La valeur sera prise en compte uniquement si la propriété TypeJauge correspond à la constante notifJaugeStandard.
Cette fonctionnalité est disponible à partir de Android 3.0.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
VibrationBooléen
  • Vrai si l'appareil doit vibrer lors de l'affichage de la notification,
  • Faux (valeur par défaut) dans le cas contraire.
Remarque : La durée et la puissance des vibrations peuvent varier d'un appareil à l'autre.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.

Propriétés spécifiques à la description des variables de type Notification pour une notification push

Les propriétés suivantes peuvent être utilisées pour manipuler une notification :
Nom de la propriétéType manipuléEffet
ActiveApplicationBooléen
  • Vrai si l'application doit être mise au premier plan lors du clic sur la notification.
  • Faux (valeur par défaut) dans le cas contraire.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
AffichageLEDBooléen
  • Vrai si la LED de l'appareil doit être allumée lors de l'affichage de la notification,
  • Faux (valeur par défaut) dans le cas contraire.
La couleur et la fréquence d'allumage de la LED peuvent varier d'un appareil à l'autre.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
BadgeEntierNuméro affiché par l'icône de l'application.
Android Cette propriété est supportée sous Android à partir de Android 8.0.
CatégorienotificationCatégorieCatégorie associée à la notification. Les catégories de notification sont disponibles à partir d'Android 8.0 (API level 26). Si l'application s'exécute sur une version plus ancienne la propriété Catégorie sera ignorée.
Il est conseillé de toujours associer une catégorie à une notification
  • Si la catégorie n'existe pas au moment de l'ajout de la notification, elle sera automatiquement créée,
  • Si la catégorie existe déjà pour l'application, la notification sera associée à la catégorie existante.
  • Si aucune catégorie n'a été spécifiée, la notification sera automatiquement associée à une catégorie prédéfinie en fonction de son niveau de priorité. Les catégories prédéfinies sont les suivantes :
    • Priorité min.
    • Priorité faible
    • Priorité normale
    • Priorité élevée
    • Priorité max.
    La catégorie prédéfinie sera créée lors du premier ajout d'une notification sans catégorie avec le niveau de priorité correspondant et utilisera les paramètres visuels et auditifs de cette notification (vibreur, son, led, ...). Ces paramètres pourront ensuite être modifiés par l'utilisateur final. Si la catégorie prédéfinie existe déjà, la notification héritera des propriétés de cette catégorie.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
ChronomètreBooléen
  • Vrai pour afficher un chronomètre à la place de l'heure de la notification. Le chronomètre démarrera automatiquement lors de la réception de la notification et son affichage sera mis à jour automatiquement.
  • Faux (valeur par défaut) pour ne pas afficher de chronomètre. L'heure associée à la notification sera affichée.
Attention : L'affichage d'un chronomètre dans les notifications est disponible à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le chronomètre sera ignoré et l'heure associée à la notification sera affichée.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
ContenuChaîne de caractèresDonnées personnalisées de la notification. Ces données ne sont pas affichées dans la notification.
CouleurLEDEntierCouleur de la LED lors de l'affichage de la notification.
La valeur de cette propriété est prise en compte uniquement si la propriété AffichageLED vaut Vrai.
Par défaut, la couleur d'affichage de la LED est verte.
Cette couleur peut correspondre à :
Attention : Certains appareils ne permettent pas de modifier la couleur de la LED ou ne proposent que certaines couleurs. Si la couleur spécifiée n'est pas supportée par l'appareil, une couleur par défaut sera utilisée.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
FormatnotificationFormatFormat d'affichage de la notification lorsque celle-ci est déroulée.
Attention : L'affichage des notifications en mode "déroulé" est disponible uniquement à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le format d'affichage sera ignoré.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
GrandeIconeChaîne de caractèresChemin de l'image correspondant à la grande icône associée à la notification. Cette icône sera affichée à gauche du titre et du message de la notification.
Si aucune image n'est spécifiée, l'icône spécifiée par la propriété Icone sera utilisée. Si cette dernière n'est pas spécifiée, l'icône de l'application sera utilisée.
Attention : L'affichage de cette image dans les notifications est possible uniquement pour les appareils disposant d'Android 3.0 ou supérieure (Honeycomb, api level 11). Sur des appareils en version inférieure, cette image sera ignorée.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
GroupeChaîne de caractèresNom du groupe auquel est associée la notification push.
Si plusieurs notifications push appartenant au même groupe sont envoyées avec un contenu identique alors que l'appareil destination ne peut être joint, lorsque l'appareil sera à nouveau contacté par le serveur Google Cloud Messaging, seule la dernière notification du groupe sera envoyée.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
IconeChaîne de caractèresChemin de l'image correspondant à l'icône associée à la notification.
Si aucune icône n'est spécifiée, l'icône de l'application sera utilisée.
LibelléActionChaîne de caractèresLibellé du bouton d'action de la notification.
Android Cette propriété n'est pas disponible.
LocaleBooléen
  • Vrai si la notification est locale à l'appareil qui la reçoit : cette notification ne doit pas être transmise aux objets fonctionnant sous Android Wear connectés à l'appareil (par exemple, une montre).
  • Faux (valeur par défaut) si la notification doit être transmise automatiquement aux objets connectés.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
MessageChaîne de caractèresMessage de la notification.
MessageSecondaireChaîne de caractèresMessage secondaire affiché en dessous du message principal de la notification.
Attention : L'affichage d'un message secondaire dans les notifications est disponible à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le message secondaire sera ignoré.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
PrioritéConstante de type EntierPriorité de la notification.
Le changement de priorité d'une notification permet de modifier sa position d'affichage dans la liste des notifications de l'appareil afin que l'utilisateur puisse voir les notifications les plus importantes en premier. Une notification avec une priorité élevée sera affichée au début de la liste alors qu'une notification avec une priorité faible sera affichée en fin de liste.
Dans certaines situations, une notification avec une priorité faible peut être masquée à l'utilisateur si d'autres notifications avec des priorités plus élevées sont reçues.
Cette propriété peut prendre les valeurs suivantes  :
  • notifPrioritéMax : priorité maximale (exemple : appel entrant).
  • notifPrioritéElévée : priorité élevée (exemple : réception d'un email urgent).
  • notifPrioritéDéfaut (valeur par défaut) : priorité normale (exemple  : réception d'un SMS).
  • notifPrioritéFaible : priorité faible (exemple  : notification de mise à jour).
  • notifPrioritéMin : priorité minimale (exemple  : information commerciale).
La modification des priorités des notifications est possible uniquement à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, la priorité sera ignorée : toutes les notifications ont la même priorité.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
SonChaîne de caractèresChemin du fichier son à jouer lors de l'affichage de la notification.
Pour jouer le son par défaut des notifications, utilisez la constante notifSonDéfaut. Ce son par défaut peut varier d'un appareil à l'autre.
Il est possible de jouer un son issu d'un fichier audio intégré à l'application (via l'assistant de génération) : il suffit d'indiquer le nom de fichier et son extension.
Pour ne pas associer de son à la notification, utilisez la valeur chaîne vide ("", valeur par défaut).
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
SupprimableBooléen
  • Vrai (valeur par défaut) si la notification peut être supprimée par l'utilisateur,
  • Faux dans le cas contraire.
Si cette propriété vaut Faux, la notification sera effacée uniquement dans les cas suivants :
  • Fermeture de l'application.
  • Appel de la fonction NotifSupprime.
  • Si la procédure WLangage exécutée lors du clic (propriété ActionClic) a retourné Vrai ou n'a pas retourné de valeur.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
TexteDéroulantChaîne de caractèresTexte déroulant affiché furtivement dans la barre système lors de l'affichage de la notification.
Si cette propriété vaut chaîne vide ("", valeur par défaut), aucun message ne sera affiché.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
TitreChaîne de caractèresTitre de la notification.
Si aucun titre n'est spécifié, le nom de l'application sera utilisé.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.
VibrationBooléen
  • Vrai si l'appareil doit vibrer lors de l'affichage de la notification,
  • Faux (valeur par défaut) dans le cas contraire.
Remarque : La durée et la puissance des vibrations peuvent varier d'un appareil à l'autre.
Android Gestion des catégories de notification (à partir de Android 8.0) :
  • Si une catégorie a été spécifiée lors de l'ajout de la notification (propriété Catégorie), cette propriété est ignorée. La notification utilisera la propriété correspondante pour la catégorie à laquelle la notification est associée.
  • Si aucune catégorie n'a été spécifiée lors de l'ajout de la notification (propriété Categorie), la notification sera associée à la catégorie prédéfinie correspondant à la valeur de la propriété Priorité.
    • Si la catégorie pré-définie existe, cette propriété est ignorée : la notification utilisera la propriété correspondante de la catégorie prédéfinie à laquelle elle est associée.
    • Si la catégorie prédéfinie n'existe pas encore, cette propriété est utilisée pour fixer les propriétés de la catégorie prédéfinie à créer.
iPhone/iPadWidget IOS Cette propriété n'est pas disponible.

Fonctions utilisant le type Notification

Les fonctions suivantes manipulent les variables de type Notification pour une notification locale :
NotifAjouteAjoute une notification dans la barre système de l'appareil (Android) ou dans le centre de notification (iOS).
NotifModifieModifie une notification actuellement affichée dans la barre système de l'appareil.
NotifPushEnvoieEnvoie une notification push (distante) à un appareil mobile (iOS ou Android).
NotifSupprimeSupprime une notification affichée dans la barre système de l'appareil.
ThreadPersistantRend un thread persistant.

Réinitialisation

Pour réinitialiser le contenu d'une variable de type Notification, il est possible d'utiliser la fonction VariableRAZ.
Liste des exemples associés :
WM Push Exemples multiplateforme : WM Push
[ + ] Cet exemple montre comment recevoir des notifications Push.
Il appelle la fonction NotifPushActive et envoie l'identifiant obtenu à l'exemple WINDEV "WD Serveur Push" afin qu'il le stocke.
Cet identifiant est ensuite lu par l'exemple WINDEV "Envoi Push" afin qu'il envoie les notifications en push à cet exemple.
WD_Serveur_Push Exemples multiplateforme : WD_Serveur_Push
[ + ] Cet exemple est un webservice servant à stocker les identifiants nécessaires au Push sur mobiles.
L'application WINDEV Mobile WM Push stockent les identifiants Push dans la base de cet exemple.
Ces identifiants sont ensuite lus par l'exemple "WD Envoi Push" afin qu'il envoie les notifications.
Envoi Push Exemples multiplateforme : Envoi Push
[ + ] Cet exemple permet d'envoyer des notifications en push sur des appareils Android et iOS.
Il récupère les identifiants des mobiles dans la base HFSQL de l'exemple "WD Serveur Push", et leur envoie ensuite les notifications grâce à la fonction NotifPushEnvoie.
WM Système Exemples multiplateforme (WINDEV Mobile) : WM Système
[ + ] Cette application est un exemple didactique montrant quelques unes des fonctionnalités de WINDEV Mobile pour Android/iOS.
Les fonctions système utilisées sont :
- NFC
- Champ Multimédia
- Luminosité
- Volume
- WIFI
- Bluetooth
- Toast
- Boussole
- Accéléromètre
- Champ caméra
- LED
- Vibrations
- Notifications
- Fonctions de dessin
- Internet
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire