BadgeUpdateManager Classe

Définition

Espace de noms:

Windows.UI.Notifications

Crée des objets BadgeUpdater que vous utilisez pour manipuler la superposition de badge d’une vignette. Cette classe permet également d’accéder au contenu XML des modèles de badge fournis par le système afin que vous puissiez personnaliser ce contenu pour l’utiliser lors de la mise à jour de vos badges.

public ref class BadgeUpdateManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdateManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class BadgeUpdateManager

Public Class BadgeUpdateManager

Héritage

Object Platform::Object IInspectable BadgeUpdateManager

Attributs

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple suivant illustre l’utilisation de GetTemplateContent pour créer le contenu d’un badge numérique et de CreateBadgeUpdaterForApplication pour envoyer une mise à jour de badge numérique à la vignette de l’application appelante.

function sendBadgeNotification() {
    var Notifications = Windows.UI.Notifications;
    var badgeXml;
    var badgeAttributes;

    // Get an XML DOM version of a specific template by using getTemplateContent.
    badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
    badgeAttributes = badgeXml.getElementsByTagName("badge");
    badgeAttributes[0].setAttribute("value", "7");

    // Create a badge notification from the XML content.
    var badgeNotification = new Notifications.BadgeNotification(badgeXml);

    // Send the badge notification to the app's tile.
    Notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);
}

Remarques

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	GetForUser

Méthodes

CreateBadgeUpdaterForApplication()	Crée et initialise une nouvelle instance de BadgeUpdater, qui vous permet de modifier l’apparence ou le contenu du badge sur la vignette de l’application appelante.
CreateBadgeUpdaterForApplication(String)	Crée et initialise une nouvelle instance du BadgeUpdater pour le badge d’une vignette d’application spécifiée, généralement la vignette d’une autre application dans le package. BadgeUpdater vous permet de modifier l’apparence ou le contenu de ce badge.
CreateBadgeUpdaterForSecondaryTile(String)	Crée et initialise une nouvelle instance de BadgeUpdater, qui vous permet de modifier l’apparence ou le contenu d’un badge sur une vignette secondaire. La vignette peut appartenir à l’application appelante ou à toute autre application dans le même package.
GetForUser(User)	Crée et initialise un nouveau BadgeUpdateManagerForUser pour l’utilisateur spécifié, ce qui vous permet de modifier l’apparence ou le contenu du badge sur une vignette pour un utilisateur spécifique.
GetTemplateContent(BadgeTemplateType)	Obtient le contenu XML de l’un des modèles de badge prédéfinis afin que vous puissiez le personnaliser pour une mise à jour de badge.

Voir aussi

• Exemple de vignettes et de badges d’application
• Recommandations et liste de vérification sur les vignettes et les badges
• Comment effacer un badge
• Comment envoyer un glyphe ou un badge numérique dans une notification locale
• Comment configurer des notifications périodiques pour les badges
• Comment mettre à jour un badge via des notifications Push
• Schéma XML du badge
• Vue d’ensemble des badges