Поделиться через


BadgeUpdater Класс

Определение

Обновления наложение индикатора событий на определенной плитке, к которому привязано средство обновления.

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
Наследование
Object Platform::Object IInspectable BadgeUpdater
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем примере показано использование Update для отправки числового обновления индикатора событий на плитку вызывающего приложения.

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

Комментарии

Чтобы получить экземпляр этого объекта, вызовите метод BadgeUpdateManager.CreateBadgeUpdaterForApplication или BadgeUpdateManager.CreateBadgeUpdaterForSecondaryTile .

При создании BadgeUpdater привязывается к определенному приложению или вторичной плитке, поэтому методы этого класса влияют только на одну плитку, к которому привязан экземпляр объекта.

Методы

Clear()

Удаляет эмблему с плитки, к которому привязано средство обновления.

StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)

Начинает серию обновлений по времени для индикатора событий с веб-ресурса, к которому привязано средство обновления. Обновления начинаться в указанное время. Обратите внимание, что в периодическом обновлении разрешены только веб-ресурсы (http/https).

StartPeriodicUpdate(Uri, PeriodicUpdateRecurrence)

Начинает серию повременных обновлений для индикатора событий с веб-ресурса, к которому привязано средство обновления, начиная с немедленного начала. Обратите внимание, что в периодическом обновлении разрешены только веб-ресурсы (http/https).

StopPeriodicUpdate()

Отменяет текущую последовательность временных обновлений для индикатора событий, к которому привязано средство обновления.

Update(BadgeNotification)

Применяет изменение к глифу или номеру эмблемы.

Применяется к

См. также раздел