BadgeUpdateManager Classe

Référence

Définition

Espace de noms:: Windows.UI.Notifications

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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

S’applique à

Partager via