BadgeNotification Класс

Определение

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

Windows.UI.Notifications

Определяет содержимое, связанные метаданные и время окончания срока действия обновления наложения индикатора событий плитки. Эмблема может отображать число от 1 до 99 или глиф состояния.

public ref class BadgeNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IBadgeNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class BadgeNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IBadgeNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class BadgeNotification

function BadgeNotification(content)

Public NotInheritable Class BadgeNotification

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

Object Platform::Object IInspectable BadgeNotification

Атрибуты

ActivatableAttribute 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)

Примеры

В следующем примере кода используется метод BadgeNotification для создания числовых уведомлений индикатора событий. Если вы использовали этот метод, чтобы задать значение "0", эмблема будет удалена.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "26");

// Create a badge notification from XML
var badgeNotification = new Notifications.badgeNotification(badgeXml);

В следующем примере кода используется метод BadgeNotification для создания уведомления о эмблеме глифа. Если вы использовали этот метод, чтобы задать значение "нет", эмблема будет очищена.

var Notifications = Windows.UI.Notifications;

var badgeXml = Notifications.BadgeUpdateManager.getTemplateContent(Notifications.BadgeTemplateType.badgeNumber);
var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "alert");

// Create a badge notification from XML
var badgeNotification = new Notifications.badgeNotification(badgeXml);

Конструкторы

BadgeNotification(XmlDocument)

Создает и инициализирует новый экземпляр BadgeNotification.

Свойства

Content	Возвращает XML-код, определяющий значение или глиф, используемый в качестве индикатора событий плитки.
ExpirationTime	Возвращает или задает время удаления эмблемы Windows с плитки. По умолчанию срок действия локальных уведомлений о индикаторах событий не истекает, а push-уведомления, периодические и запланированные уведомления о индикаторах событий истекают через три дня. Рекомендуется явно задать срок действия, чтобы избежать устаревшего содержимого.

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

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