BadgeUpdater 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

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: ContractVersionAttribute 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 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 à

Partager via