Уведомления эмблем для приложений Windows
Плитка с отображением числового индикатора событий
число 63 для уведомления о 63 непрочитанных сообщениях.
Индикатор событий передает сводную информацию или информацию о статусе, характерную для приложения. Логотипом может быть число (1–99) или один из глифов, предоставленных системой. Примеры уведомлений, наилучшим образом передаваемых через индикатор событий: состояние сетевого подключения в сетевой игре, состояние пользователя в приложении для обмена сообщениями, количество непрочитанных писем в почтовом приложении и количество новых публикаций в приложении для социальных сетей.
Уведомления на индикаторах событий появляются на значке вашего приложения в панели задач и в правом нижнем углу его запускающей плитки независимо от того, запущено оно или нет. Индикаторы событий могут отображаться на плитках любого размера.
Примечание
Вы не можете предоставить собственное изображение индикатора. Использовать можно только изображения, предоставленные системой.
Числовые индикаторы событий
Значение | Значок | XML |
---|---|---|
Число от 1 до 99. Значение 0 эквивалентно значению глифа "none" и удаляет индикатор события. | <badge value="1"/> |
|
Любое число больше 99. | <badge value="100"/> |
Индикаторы событий с глифами состояния
Вместо числа индикатор событий может отображать один из нерасширяемых наборов глифов состояния.
Состояние | Глиф | XML |
---|---|---|
нет | (Индикатор событий не отображается). | <badge value="none"/> |
activity | <badge value="activity"/> |
|
будильник | <badge value="alarm"/> |
|
предупреждение | <badge value="alert"/> |
|
внимание | <badge value="attention"/> |
|
доступен | <badge value="available"/> |
|
отошел | <badge value="away"/> |
|
занят | <badge value="busy"/> |
|
error | <badge value="error"/> |
|
newMessage | <badge value="newMessage"/> |
|
пауза | <badge value="paused"/> |
|
воспроизведение | <badge value="playing"/> |
|
недоступен | <badge value="unavailable"/> |
Создание индикатора событий
В этих примерах показано, как создать обновление индикатора событий.
Создание числового индикатора событий
private void setBadgeNumber(int num)
{
// Get the blank badge XML payload for a badge number
XmlDocument badgeXml =
BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeNumber);
// Set the value of the badge in the XML to our number
XmlElement badgeElement = badgeXml.SelectSingleNode("/badge") as XmlElement;
badgeElement.SetAttribute("value", num.ToString());
// Create the badge notification
BadgeNotification badge = new BadgeNotification(badgeXml);
// Create the badge updater for the application
BadgeUpdater badgeUpdater =
BadgeUpdateManager.CreateBadgeUpdaterForApplication();
// And update the badge
badgeUpdater.Update(badge);
}
Создание индикатора событий с глифом
private void updateBadgeGlyph()
{
string badgeGlyphValue = "alert";
// Get the blank badge XML payload for a badge glyph
XmlDocument badgeXml =
BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);
// Set the value of the badge in the XML to our glyph value
Windows.Data.Xml.Dom.XmlElement badgeElement =
badgeXml.SelectSingleNode("/badge") as Windows.Data.Xml.Dom.XmlElement;
badgeElement.SetAttribute("value", badgeGlyphValue);
// Create the badge notification
BadgeNotification badge = new BadgeNotification(badgeXml);
// Create the badge updater for the application
BadgeUpdater badgeUpdater =
BadgeUpdateManager.CreateBadgeUpdaterForApplication();
// And update the badge
badgeUpdater.Update(badge);
}
Очистка индикатора событий
private void clearBadge()
{
BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();
}
Получение примера кода
- Пример уведомлений
Демонстрирует, как создавать интерактивные плитки, отправлять обновления индикатора событий и отображать всплывающие уведомления.
Похожие статьи
Windows developer
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по