BadgeUpdateManager Класс

Определение

Пространство имен:

Windows.UI.Notifications

Создает объекты BadgeUpdater , которые используются для управления наложением значков плитки. Этот класс также предоставляет доступ к XML-содержимому предоставленных системой шаблонов индикаторов событий, что позволяет настроить это содержимое для использования при обновлении индикаторов событий.

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

Наследование

Object Platform::Object IInspectable BadgeUpdateManager

Атрибуты

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Требования к 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)

Примеры

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

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

Комментарии

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	GetForUser

Методы

CreateBadgeUpdaterForApplication()	Создает и инициализирует новый экземпляр BadgeUpdater, который позволяет изменять внешний вид или содержимое индикатора событий на плитке вызывающего приложения.
CreateBadgeUpdaterForApplication(String)	Создает и инициализирует новый экземпляр BadgeUpdater для эмблемы указанной плитки приложения, обычно плитки другого приложения в пакете. BadgeUpdater позволяет изменить внешний вид или содержимое этого индикатора событий.
CreateBadgeUpdaterForSecondaryTile(String)	Создает и инициализирует новый экземпляр BadgeUpdater, который позволяет изменять внешний вид или содержимое индикатора событий на дополнительной плитке. Плитка может принадлежать вызывающей приложению или любому другому приложению в том же пакете.
GetForUser(User)	Создает и инициализирует новый BadgeUpdateManagerForUser для указанного пользователя, который позволяет изменять внешний вид или содержимое индикатора событий на плитке для определенного пользователя.
GetTemplateContent(BadgeTemplateType)	Получает XML-содержимое одного из стандартных шаблонов индикаторов событий, чтобы его можно было настроить для обновления индикатора событий.

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

• Пример плиток и индикаторов событий приложения
• Руководство и контрольный список по плиткам и индикаторам событий
• Как очистить эмблему
• Отправка глифа или цифровой эмблемы в локальном уведомлении
• Настройка периодических уведомлений для индикаторов событий
• Обновление индикатора событий с помощью push-уведомлений
• Схема XML индикатора событий
• Общие сведения о индикаторах событий