Notificações de selo para aplicativos Windows

Um selo de notificação transmite informações de resumo ou status específicas para seu aplicativo. Eles podem ser numéricos (1 a 99) ou um de um conjunto de glifos fornecidos pelo sistema. Exemplos de informações melhor transmitidas por meio de um selo incluem status de conexão de rede em um jogo online, status do usuário em um aplicativo de mensagens, número de emails não lidos em um aplicativo de email e 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. Os emblemas podem ser exibidos em todos os tamanhos de azulejo.

Note

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

Selos numéricos

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

Selos de glifo

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 selo mostrado.) <badge value="none"/>
atividade Um selo de glifo que indica o status de <badge value="activity"/>
alarm Um selo de glifo que indica o status de <badge value="alarm"/>
alerta Um selo de glifo que indica o status de <badge value="alert"/>
attention Um selo de glifo que indica o status de <badge value="attention"/>
available Um selo de glifo que indica o status <badge value="available"/>
away Um selo de glifo que indica o status 'away'. <badge value="away"/>
busy Um selo de glifo que indica o status <badge value="busy"/>
erro Um selo de glifo que indica o status de <badge value="error"/>
newMessage Um selo de glifo que indica o status 'newMessage'. <badge value="newMessage"/>
paused Um selo de glifo que indica o status 'pausado'. <badge value="paused"/>
playing Um selo de glifo que indica o status de <badge value="playing"/>
unavailable Um selo de glifo que indica o status 'indisponível'. <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 emblema

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

Obter o código de exemplo

  • Last updated on