BadgeUpdateManager Klasse

Definition

Namespace:

Windows.UI.Notifications

Erstellt BadgeUpdater-Objekte , die Sie zum Bearbeiten der Badgeüberlagerung einer Kachel verwenden. Diese Klasse bietet auch Zugriff auf den XML-Inhalt der vom System bereitgestellten Badgevorlagen, sodass Sie diesen Inhalt für die Aktualisierung Ihrer Badges anpassen können.

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

Vererbung

Object Platform::Object IInspectable BadgeUpdateManager

Attribute

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das folgende Beispiel zeigt die Verwendung von GetTemplateContent zum Erstellen des Inhalts für einen numerischen Badge und CreateBadgeUpdaterForApplication zum Senden einer numerischen Signalaktualisierung an die Kachel der aufrufenden App.

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);
}

Hinweise

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	GetForUser

Methoden

CreateBadgeUpdaterForApplication()	Erstellt und initialisiert eine neue instance von BadgeUpdater, mit der Sie die Darstellung oder den Inhalt des Badges auf der Kachel der aufrufenden App ändern können.
CreateBadgeUpdaterForApplication(String)	Erstellt und initialisiert eine neue instance des BadgeUpdater für das Badge einer angegebenen App-Kachel, in der Regel die Kachel einer anderen App im Paket. Mit BadgeUpdater können Sie die Darstellung oder den Inhalt dieses Badges ändern.
CreateBadgeUpdaterForSecondaryTile(String)	Erstellt und initialisiert eine neue instance von BadgeUpdater, mit der Sie die Darstellung oder den Inhalt eines Badges auf einer sekundären Kachel ändern können. Die Kachel kann zur aufrufenden App oder einer beliebigen anderen App im selben Paket gehören.
GetForUser(User)	Erstellt und initialisiert einen neuen BadgeUpdateManagerForUser für den angegebenen Benutzer, mit dem Sie die Darstellung oder den Inhalt des Badges auf einer Kachel für einen bestimmten Benutzer ändern können.
GetTemplateContent(BadgeTemplateType)	Ruft den XML-Inhalt einer der vordefinierten Badgevorlagen ab, damit Sie ihn für eine Badgeaktualisierung anpassen können.

Weitere Informationen

• Beispiel für App-Kacheln und -Badges
• Richtlinien und Prüfliste für Kacheln und Signale
• Löschen eines Badges
• Senden einer Glyphe oder eines numerischen Badges in einer lokalen Benachrichtigung
• So wird's gemacht: Einrichten regelmäßiger Benachrichtigungen für Signale
• So wird's gemacht: Aktualisieren eines Signals durch Pushbenachrichtigungen
• Signal-XML-Schema
• Übersicht über Badges