Freigeben über


BadgeUpdater Klasse

Definition

Updates eine Signalüberlagerung auf der bestimmten Kachel, an die der Updater gebunden ist.

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
Vererbung
Object Platform::Object IInspectable BadgeUpdater
Attribute

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 Update , um ein numerisches Signalupdate an die Kachel der aufrufenden App zu senden.

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

Um eine instance dieses Objekts abzurufen, rufen Sie die BadgeUpdateManager.CreateBadgeUpdaterForApplication- oder BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile-Methode auf.

Bei der Erstellung wird BadgeUpdater an eine bestimmte App oder sekundäre Kachel gebunden, sodass die Methoden dieser Klasse nur die einzelne Kachel beeinflussen, an die das Objekt instance gebunden ist.

Methoden

Clear()

Entfernt den Badge aus der Kachel, an die der Updater gebunden ist.

StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)

Startet eine Reihe von zeitlimitierten Updates für den Badge aus einer Webressource, an die der Updater gebunden ist. Updates zu einem bestimmten Zeitpunkt beginnen. Beachten Sie, dass in regelmäßigen Updates nur Webressourcen (http/https) zulässig sind.

StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)

Startet eine Reihe von zeitlimitierten Updates für den Badge aus einer Webressource, an die der Updater gebunden ist, und beginnt sofort. Beachten Sie, dass in regelmäßigen Updates nur Webressourcen (http/https) zulässig sind.

StopPeriodicUpdate()

Bricht die aktuelle Reihe zeitgebundener Updates für den Badge ab, an den der Updater gebunden ist.

Update(BadgeNotification)

Wendet eine Änderung auf die Glyphe oder Nummer des Badges an.

Gilt für:

Weitere Informationen