Notifications de badge pour les applications Windows

  • Article

Un badge de notification transmet des informations spécifiques de résumé ou d’état à votre application. Ils peuvent être numériques (1 à 99) ou l’un d’un ensemble de glyphes fournis par le système. Des exemples d’informations mieux transmises via un badge incluent l’état de connexion réseau dans un jeu en ligne, l’état utilisateur dans une application de messagerie, le nombre de courriers non lus dans une application de messagerie et le nombre de nouveaux billets dans une application de médias sociaux.

Les badges de notification s’affichent sur l’icône de la barre des tâches de votre application et dans le coin inférieur droit de sa vignette de démarrage, que l’application soit en cours d’exécution. Les badges peuvent être affichés sur toutes les tailles de vignette.

Remarque

Vous ne pouvez pas fournir votre propre image de badge ; seules les images de badge fournies par le système peuvent être utilisées.

Badges numériques

Valeur Badge XML
Nombre compris entre 1 et 99. La valeur 0 équivaut à la valeur de glyphe « none » et efface le badge. Un badge numérique inférieur à 100. <badge value="1"/>
Nombre supérieur à 99. Badge numérique supérieur à 99. <badge value="100"/>

Badges de glyphe

Au lieu d’un nombre, un badge peut afficher un ensemble non extensible de glyphes d’état.

État Glyphe XML
Aucune (Aucun badge affiché.) <badge value="none"/>
activity <badge value="activity"/>
alarme <badge value="alarm"/>
alerte <badge value="alert"/>
attention <badge value="attention"/>
disponible <badge value="available"/>
dès maintenant <badge value="away"/>
busy <badge value="busy"/>
error <badge value="error"/>
newMessage <badge value="newMessage"/>
Pause <badge value="paused"/>
jeu <badge value="playing"/>
non disponible <badge value="unavailable"/>

Créer un badge

Ces exemples vous montrent comment créer une mise à jour de badge.

Créer un badge numérique

private void setBadgeNumber(int num)
{

    // Get the blank badge XML payload for a badge number
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);

    // Set the value of the badge in the XML to our number
    XmlElement badgeElement = badgeXml.SelectSingleNode("/badge") as XmlElement;
    badgeElement.SetAttribute("value", num.ToString());

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Créer un badge de glyphe

private void updateBadgeGlyph()
{
    string badgeGlyphValue = "alert";

    // Get the blank badge XML payload for a badge glyph
    XmlDocument badgeXml = 
        BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);

    // Set the value of the badge in the XML to our glyph value
    Windows.Data.Xml.Dom.XmlElement badgeElement = 
        badgeXml.SelectSingleNode("/badge") as Windows.Data.Xml.Dom.XmlElement;
    badgeElement.SetAttribute("value", badgeGlyphValue);

    // Create the badge notification
    BadgeNotification badge = new BadgeNotification(badgeXml);

    // Create the badge updater for the application
    BadgeUpdater badgeUpdater = 
        BadgeUpdateManager.CreateBadgeUpdaterForApplication();

    // And update the badge
    badgeUpdater.Update(badge);

}

Effacer un badge

private void clearBadge()
{
    BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();
}

Obtenir l’exemple de code

  • Exemple de notifications
    Montre comment créer des vignettes actives, envoyer des mises à jour de badge et afficher des notifications toast.