Notification (Type de variable)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions de gestion du téléphone

Utilisation du type Notification
Tableau récapitulatif des propriétés disponibles selon le type de notification et la plateforme
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

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Notification (Type de variable)

En anglais : Notification

Le type Notification permet de manipuler

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)

// 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 :

les propriétés spécifiques à la description des variables de type Notification pour une notification locale.
les propriétés spécifiques à la description des variables de type Notification pour une notification push.

Tableau récapitulatif des propriétés disponibles selon le type de notification et la plateforme


Nom de la propriété	Notification locale		Notification push
	Android	IOS	Android	IOS
ActionClic	x	x	x
ActionSupplémentaire	x
ActiveApplication	x
AffichageLED	x		x
AlerteUneFois	x
Badge	x	x	x	x
Catégorie	x		x
Chronomètre	x		x
Contenu	x	x	x	x
CouleurLED	x		x
DateHeureActivation		x
Format	x		x
GrandeIcone	x		x
Groupe			x
Icone	x	x	x	x
LibelléAction		x		x
Locale	x		x
MaxJauge	x
Message	x	x	x	x
MessageSecondaire	x		x
Priorité	x		x
Son	x	x	x	x
Supprimable	x		x
TexteDéroulant	x		x
Titre	x	x	x
TypeJauge	x
ValeurJauge	x
Vibration	x		x

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

ActionClic	Valeur ou nom de procédure	Nom 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 : la notification sera automatiquement supprimée de la barre système. 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émentaire	Tableau de variables de type notificationAction	Actions 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. Cette propriété n'est pas disponible.
ActiveApplication	Boolé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. Cette propriété n'est pas disponible.
AffichageLED	Boolé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. 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. Cette propriété n'est pas disponible.
AlerteUneFois	Booléen	Permet 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. Cette propriété n'est pas disponible.
Badge	Entier	Numéro affiché par l'icône de l'application. Cette propriété est supportée sous Android à partir de Android 8.0.
Catégorie	notificationCatégorie	Caté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. Cette propriété n'est pas disponible.
Chronomètre	Boolé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. Cette propriété n'est pas disponible.
Contenu	Chaîne de caractères	Données personnalisées de la notification. Ces données ne sont pas affichées dans la notification.
CouleurLED	Entier	Couleur 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 à : une couleur RVB (obtenue avec la fonction RVB), une composante TSL de la couleur (obtenue avec la fonction TSL), une couleur prédéfinie du WLangage. 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. 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. Cette propriété n'est pas disponible.
DateHeureActivation	DateHeure ou chaîne de caractères	Date et heure auxquelles la notification doit être envoyée. Par défaut, la notification est envoyée immédiatement. Cette propriété n'est pas disponible.
Format	notificationFormat	Format 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é. Cette propriété n'est pas disponible.
GrandeIcone	Chaîne de caractères	Chemin 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. Cette propriété n'est pas disponible.
Icone	Chaîne de caractères	Chemin 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. 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éAction	Chaîne de caractères	Libellé du bouton d'action de la notification. Cette propriété n'est pas disponible.
Locale	Boolé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. Cette propriété n'est pas disponible.
MaxJauge	Entier	Valeur 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. Cette propriété n'est pas disponible.
Message	Chaîne de caractères	Message de la notification.
MessageSecondaire	Chaîne de caractères	Message 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é. Cette propriété n'est pas disponible.
Priorité	Constante de type Entier	Priorité 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é. 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. Cette propriété n'est pas disponible.
Son	Chaîne de caractères	Chemin 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). 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. 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).
Supprimable	Boolé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. Cette propriété n'est pas disponible.
TexteDéroulant	Chaîne de caractères	Texte 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é. Cette propriété n'est pas disponible.
Titre	Chaîne de caractères	Titre de la notification. Si aucun titre n'est spécifié, le nom de l'application sera utilisé.
TypeJauge	Constante de type Entier	Type 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. Cette propriété n'est pas disponible.
ValeurJauge	Entier	Valeur 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. Cette propriété n'est pas disponible.
Vibration	Boolé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. 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. 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

ActiveApplication	Boolé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. Cette propriété n'est pas disponible.
AffichageLED	Boolé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. 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. Cette propriété n'est pas disponible.
Badge	Entier	Numéro affiché par l'icône de l'application. Cette propriété est supportée sous Android à partir de Android 8.0.
Catégorie	notificationCatégorie	Caté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. Cette propriété n'est pas disponible.
Chronomètre	Boolé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. Cette propriété n'est pas disponible.
Contenu	Chaîne de caractères	Données personnalisées de la notification. Ces données ne sont pas affichées dans la notification.
CouleurLED	Entier	Couleur 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 à : une couleur RVB (obtenue avec la fonction RVB), une composante TSL de la couleur (obtenue avec la fonction TSL), une couleur prédéfinie du WLangage. 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. 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. Cette propriété n'est pas disponible.
Format	notificationFormat	Format 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é. Cette propriété n'est pas disponible.
GrandeIcone	Chaîne de caractères	Chemin 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. Cette propriété n'est pas disponible.
Groupe	Chaîne de caractères	Nom 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. Cette propriété n'est pas disponible.
Icone	Chaîne de caractères	Chemin 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éAction	Chaîne de caractères	Libellé du bouton d'action de la notification. Cette propriété n'est pas disponible.
Locale	Boolé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. Cette propriété n'est pas disponible.
Message	Chaîne de caractères	Message de la notification.
MessageSecondaire	Chaîne de caractères	Message 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é. Cette propriété n'est pas disponible.
Priorité	Constante de type Entier	Priorité 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é. 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. Cette propriété n'est pas disponible.
Son	Chaîne de caractères	Chemin 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). 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.
Supprimable	Boolé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. Cette propriété n'est pas disponible.
TexteDéroulant	Chaîne de caractères	Texte 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é. Cette propriété n'est pas disponible.
Titre	Chaîne de caractères	Titre de la notification. Si aucun titre n'est spécifié, le nom de l'application sera utilisé. Cette propriété n'est pas disponible.
Vibration	Boolé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. 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. 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 :


NotifAjoute	Ajoute une notification dans la barre système de l'appareil (Android) ou dans le centre de notification (iOS).
NotifModifie	Modifie une notification actuellement affichée dans la barre système de l'appareil.
NotifPushEnvoie	Envoie une notification push (distante) à un appareil mobile (iOS ou Android).
NotifSupprime	Supprime une notification affichée dans la barre système de l'appareil.
ThreadPersistant	Rend 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 :

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.

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.

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.

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

Voir Aussi

Version minimum requise

Version 16

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 08/07/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale