PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Propriétés spécifiques à la description des variables de type notificationCatégorie
  • Fonctions utilisant le type notificationCatégorie
  • Réinitialisation
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
notificationCatégorie (Type de variable)
En anglais : notificationCategory
Le type notificationCatégorie permet de définir toutes les caractéristiques avancées d'une catégorie de notification. Les notifications de l'application peuvent être associées à une catégorie de notification. Les caractéristiques de cette catégorie de notification peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Ce type de variable est utilisé par les variables de type Notification.
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
// Description de la catégorie de notification à utiliser
catégorieNotif est une NotificationCatégorie
catégorieNotif..Identifiant = "ID_NOTIF_COM"
catégorieNotif..Nom = "Notifications commerciales"
catégorieNotif..Priorité = notifPrioritéElevée

// Ajout d’une notification associée à la catégorie
n est une Notification
n..Titre = "Nouveau message"
n..Message = "Commande n°54781-4551"
n..MessageSecondaire = "client@societe.com"
n..Catégorie = catégorieNotif
NotifAjoute(n)
Remarques

Propriétés spécifiques à la description des variables de type notificationCatégorie

Les propriétés suivantes peuvent être utilisées pour manipuler une catégorie de notification :
Nom de la propriétéType manipuléEffet
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.
BadgeActifBooléen
  • Vrai (valeur par défaut) si les notifications de la catégorie doivent être prise en compte pour l’affichage du badge de l’application.
  • Faux dans le cas contraire.
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.
DescriptionChaîne de caractèresDescription (optionnelle) de la catégorie de notification.
IdentifiantChaîne de caractèresIdentifiant de la catégorie. Cette propriété ne doit pas être vide. Cet identifiant est unique pour l’application (sensible à la casse et l'accentuation).
NomChaîne de caractèresNom de la catégorie. Ce nom ne doit pas être vide.
PrioritéEntierPriorité des notifications associées à la catégorie. La priorité d’une notification a une influence sur l’affichage de la notification à l’utilisateur.
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).
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).
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.
VisibleSurEcranVerrouillageBooléen
  • Vrai si la notification doit être visible sur l'écran de verrouillage,
  • Faux (valeur par défaut) dans le cas contraire.

Remarque : Ces propriétés peuvent être utilisées en utilisant une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>

Fonctions utilisant le type notificationCatégorie

Les fonctions suivantes manipulent les variables de type notificationCatégorie :
Versions 24 et supérieures
NotifListeCatégorie
NotifListeCatégorie
Liste les catégories de notification de l'application.
Versions 24 et supérieures
NotifSupprimeCatégorie
NotifSupprimeCatégorie
Supprime une catégorie de notification de l'application.

Réinitialisation

Pour réinitialiser le contenu d’une variable de type notificationCatégorie, il est possible d’utiliser la fonction VariableRAZ.
Version minimum requise
  • Version 24
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire