Уведомления эмблем для приложений Windows

  • Статья
Плитка с числовым индикатором событий с числом 63 для обозначения 63 непрочитанных сообщений.
Плитка с отображением числового индикатора событий
число 63 для уведомления о 63 непрочитанных сообщениях.

Индикатор событий передает сводную информацию или информацию о статусе, характерную для приложения. Логотипом может быть число (1–99) или один из глифов, предоставленных системой. Примеры уведомлений, наилучшим образом передаваемых через индикатор событий: состояние сетевого подключения в сетевой игре, состояние пользователя в приложении для обмена сообщениями, количество непрочитанных писем в почтовом приложении и количество новых публикаций в приложении для социальных сетей.

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

Примечание

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

Числовые индикаторы событий

Значение Значок XML
Число от 1 до 99. Значение 0 эквивалентно значению глифа "none" и удаляет индикатор события. Числовой индикатор событий меньше 100. <badge value="1"/>
Любое число больше 99. Числовой индикатор событий больше 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();
}

Получение примера кода

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