Notificações de ícones para aplicações do Windows

Um selo de notificação transmite informações de resumo ou status específicas do seu aplicativo. Podem ser numéricos (1-99) ou um de um conjunto de glifos fornecidos pelo sistema. Exemplos de informações melhor transmitidas por meio de um selo incluem o status da conexão de rede em um jogo online, o status do usuário em um aplicativo de mensagens, o número de e-mails não lidos em um aplicativo de email e o número de novas postagens em um aplicativo de mídia social.

Os selos de notificação aparecem no ícone da barra de tarefas do aplicativo e no canto inferior direito do bloco inicial, independentemente de o aplicativo estar em execução. As insígnias podem ser exibidas em todos os tamanhos de blocos.

Note

Você não pode fornecer sua própria imagem de selo; apenas imagens de crachás fornecidas pelo sistema podem ser usadas.

Insígnias Numéricas

Value Badge XML
Um número de 1 a 99. Um valor de 0 é equivalente ao valor do glifo "nenhum" e limpará o selo. Um emblema numérico inferior a 100. <badge value="1"/>
Qualquer número superior a 99. Um emblema numérico maior que 99. <badge value="100"/>

Distintivos de glifos

Em vez de um número, um selo pode exibir um de um conjunto não extensível de glifos de status.

Status Glyph XML
none (Nenhum crachá mostrado.) <badge value="none"/>
actividade Um emblema de glifo indicando o status de <badge value="activity"/>
alarm Um emblema de glifo indicando o status de <badge value="alarm"/>
alerta Um emblema de glifo indicando o status <badge value="alert"/>
attention Um emblema de glifo denotando o status de <badge value="attention"/>
available Um emblema de glifo indicando o status <badge value="available"/>
away Um emblema de glifo que denota o status de <badge value="away"/>
busy Um emblema de glifo denotando o status de <badge value="busy"/>
erro Um emblema de glifo indicando o status de <badge value="error"/>
newMessage Um emblema de glifo denotando o status 'newMessage'. <badge value="newMessage"/>
paused Um emblema de glifo denotando o status <badge value="paused"/>
playing Um emblema de glifo denotando o status de <badge value="playing"/>
unavailable Um emblema de glifo indicando o status <badge value="unavailable"/>

Criar um selo

Estes exemplos mostram como criar uma atualização de selo.

Criar um selo numérico

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

}

Criar um selo de glifo

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

}

Limpar um selo

private void clearBadge()
{
    BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();
}

Obter o código de exemplo

  • Last updated on