Язык: HTML | XAML

Краткое руководство: отправка обновления индикатора событий (XAML)

Applies to Windows and Windows Phone

Примечание  Не используете C#, VB и C++? Подробнее: Краткое руководство: отправка обновления индикатора событий (HTML).

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

Индикатор событий — это число или глиф, которые отображаются на плитке, чтобы обозначить состояние приложения. Индикатор событий — это наложение на плитку, а не часть самой плитки. Он может появляться в разных местах на плитке:

  • в правом нижнем углу в Windows на языке с написанием слева направо, как в английском;
  • в левом нижнем углу в Windows на языке с написанием справа налево, как в арабском;
  • в правом верхнем углу в Windows Phone 8.1 на языке с написанием слева направо;
  • в левом верхнем углу в Windows Phone 8.1 на языке с написанием справа налево.

Индикатор событий обрабатывается через собственные API и схему и обновляется через собственные уведомления. Этот раздел содержит пошаговое описание процедуры определения содержимого индикатора событий, его отправки через уведомление и удаления этого содержимого, когда оно больше не нужно. Эти действия демонстрируются через локальное уведомление, которое является простейшим уведомлением для реализации.

Примечание  В этом разделе вы работаете с содержимым уведомления непосредственно через модель DOM XML. Кроме того, это можно делать и через библиотеку NotificationsExtensions, в которой XML-содержимое представлено в форме свойств объекта, включая свойства Intellisense. Подробнее: Краткое руководство: использование библиотеки NotificationsExtensions в коде приложения. Чтобы увидеть код в этом кратком руководстве с помощью NotificationsExtensions, см. пример App tiles and badges.

Необходимые условия

Для понимания этого раздела вам понадобится:

Инструкции

1. Добавьте объявления пространств имен

Windows.UI.Notifications включает API для работы с индикаторами событий.



using Windows.UI.Notifications;
using Windows.Data.Xml.Dom;

2. Выбор отображения числа или глифа

Индикатор событий может отображать числа от 0 до 99 или один из набора определяемых системой глифов состояния. Выбираемый индикатор событий зависит от вашего сценария. Например, программа электронной почты может отображать количество непрочитанных писем или глиф "новое сообщение" при поступлении новой почты. Подробнее о доступных глифах см. в разделе Обзор индикаторов событий. Подробнее об отображении чисел и глифов см. в руководстве по плиткам и индикаторам событий.

  • Applies to Windows Phone

В Windows Phone 8.1 учтите, что в индикаторах событий на телефоне поддерживаются только глифы состояния "оповещение" и "внимание", а также числа. При отправке любых других глифов на телефон индикатор событий будет очищен.

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



XmlDocument badgeXml = BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);

В этом примере извлекается шаблон для индикатора событий с глифом.



XmlDocument badgeXml = BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);

3. Присвойте значение вашему индикатору событий.

В этом примере извлекается элемент badge из шаблона и ему присваивается числовое значение.



XmlElement badgeElement = (XmlElement)badgeXml.SelectSingleNode("/badge");
badgeElement.SetAttribute("value", "7");

Пример присвоения индикатору событий значения глифа.



XmlElement badgeElement = (XmlElement)badgeXml.SelectSingleNode("/badge");
badgeElement.SetAttribute("value", "newMessage");

4. Создайте уведомление на индикаторе событий и отправьте его в индикатор событий.

В этом примере XML, определенный в уведомлении, упаковывается и отправляется в индикатор событий.



BadgeNotification badge = new BadgeNotification(badgeXml);
BadgeUpdateManager.CreateBadgeUpdaterForApplication().Update(badge);

5. Дополнительно: очистка индикатора событий, если он более не является действительным

Если информация, переданная через число или глиф на индикаторе событий, является устаревшей либо уже не нужной, следует удалить индикатор событий. В следующем коде удаляется текущий индикатор событий с плитки вызывающего приложения. Также можно отправить значение "none" в качестве обновления индикатора событий вместо метода Clear.

Примечание  В отличие от плиток, индикатор событий можно очистить через облако.



BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();

Сводка и дальнейшие действия

В этом кратком руководстве вы определили и отправили новое содержимое в индикатор событий на плитке вашего приложения, а затем удалили его, когда оно стало недействительным.

В этом кратком руководстве обновление индикатора событий было отправлено как локальное уведомление. Вы также можете изучить и другие способы доставки с использованием запланированных, периодических и push-уведомлений. Подробнее см. в разделе Доставка уведомлений.

Связанные разделы

Общие сведения об индикаторах событий
Схема индикатора событий
Настройка периодических уведомлений для индикаторов событий
BadgeTemplateType
BadgeNotification

 

 

Показ:
© 2014 Microsoft