Partager via


BadgeUpdater Classe

Définition

Mises à jour une superposition de badge sur la vignette spécifique à laquelle la mise à jour est liée.

public ref class BadgeUpdater sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class BadgeUpdater final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeUpdater final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class BadgeUpdater
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeUpdater
Public NotInheritable Class BadgeUpdater
Héritage
Object Platform::Object IInspectable BadgeUpdater
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 montre l’utilisation de Update 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

Pour obtenir une instance de cet objet, appelez la méthode BadgeUpdateManager.CreateBadgeUpdaterForApplication ou BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile.

Lorsqu’il est créé, BadgeUpdater est lié à une application ou à une vignette secondaire spécifique, de sorte que les méthodes de cette classe affectent uniquement la vignette unique à laquelle l’objet instance est lié.

Méthodes

Clear()

Supprime le badge de la vignette à laquelle la mise à jour est liée.

StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)

Commence une série de mises à jour chronolysées pour le badge à partir d’une ressource web à laquelle l’éditeur de mise à jour est lié. Mises à jour commencer à une heure spécifiée. Notez que seules les ressources web (http/https) sont autorisées dans une mise à jour périodique.

StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)

Commence une série de mises à jour chronolysées pour le badge à partir d’une ressource web à laquelle l’éditeur de mise à jour est lié, commençant immédiatement. Notez que seules les ressources web (http/https) sont autorisées dans une mise à jour périodique.

StopPeriodicUpdate()

Annule la série actuelle de mises à jour chronométriques pour le badge auquel l’éditeur de mise à jour est lié.

Update(BadgeNotification)

Applique une modification au glyphe ou au numéro du badge.

S’applique à

Voir aussi