Partager via


BadgeUpdateManager Classe

Définition

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)]
class BadgeUpdateManager final
/// [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)]
public static class BadgeUpdateManager
[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

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.

S’applique à

Voir aussi