Idioma: HTML | XAML

Guia de início rápido: enviando uma atualização de notificação (XAML)

Applies to Windows and Windows Phone

Observação  Não está usando C#/VB/C++? Veja Guia de início rápido: enviando uma atualização de notificação (HTML).

Este tópico mostra como criar ou atualizar um selo em um bloco. Você vai enviar uma notificação de selo que inclui um glifo ou um valor numérico. Você vai ver também como remover o selo do bloco.

Uma notificação é um número ou glifo exibido no bloco para indicar o status de um aplicativo de alguma maneira. Uma notificação é uma sobreposição no bloco; ela não faz parte do bloco propriamente dito. Pode aparecer em diversos lugares no bloco:

  • No canto inferior direito no Windows usando um idioma da esquerda para a direita, como o inglês
  • No canto inferior esquerdo no Windows usando um idioma da direita para a esquerda, como o árabe
  • No canto superior direito no Windows Phone 8.1 usando um idioma da esquerda para a direita
  • No canto superior esquerdo no Windows Phone 8.1 usando um idioma da direita para a esquerda

A notificação é manipulada por suas próprias APIs e esquema e é atualizada através de suas notificações. Este tópico percorre com você pelo procedimento de definição do conteúdo de notificação, do envio desse conteúdo por meio de uma notificação e da remoção do conteúdo quando ele deixa de ser necessário. Estas ações são demonstradas através de uma notificação local, que é a notificação mais simples para implementação.

Observação  Neste tópico, você vai manipular o conteúdo de notificações diretamente pelo DOM (Document Object Model) XML. Uma abordagem opcional está disponível por meio da biblioteca NotificationsExtensions, que apresenta o conteúdo XML como propriedades de objetos, incluindo o Intellisense. Para saber mais, veja Guia de início rápido: usando a biblioteca NotificationsExtensions em seu código. Para ver o código expresso com o uso de NotificationsExtensions, veja o Exemplo de blocos e notificações de aplicativos.

Pré-requisitos

Para compreender este tópico, você precisará do seguinte:

  • Um conhecimento prático dos termos e conceitos de selo e notificação. Para saber mais, veja Blocos, selos e notificações.
  • Familiaridade com o esquema XML de selo. Para saber mais, veja Esquema de selos.
  • Capacidade de criar um aplicativo da Windows Store básico com C#, C++ ou Microsoft Visual Basic usando APIs de Tempo de Execução do Windows. Para saber mais, veja Crie seu primeiro aplicativo da Windows Store em C# ou Visual Basic.
  • Entendendo como criar um code-behind para um aplicativo da Windows Store com XAML (Extensible Markup Language).
  • Familiaridade com o XML e sua manipulação por meio de APIs DOM (Document Object Model).

Instruções

1. Adicionar declarações de namespace

Windows.UI.Notifications inclui as APIs de notificação.



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

2. Escolher quando exibir um número ou um glifo

O selo exibe números de 0 a 99 ou um conjunto de glifos de status definidos pelo sistema. A notificação escolhida depende do cenário. Por exemplo, um programa de email exibe o número de emails não lidos ou o glifo "nova mensagem" quando chegam novos emails. Para saber mais sobre os glifos disponíveis, veja Visão geral de notificação. Para saber mais sobre quando usar números ou glifos, veja Diretrizes e lista de verificação de blocos e notificações.

  • Applies to Windows Phone

Desde o Windows Phone 8.1, somente glifos de status “alerta” e “atenção”, assim como números, são permitidos para notificações de telefone. O envio de outros glifos para o telefone apagará a notificação.

Notificações numeradas e notificações com glifo são definidas por meio de modelos de notificação específicos para cada. Recupere o modelo adequado ao tipo de notificação que você escolheu. Este exemplo recupera o modelo para um selo numérico.



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

Este exemplo recupera o modelo para um selo com glifo.



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

3. Atribua um valor ao selo.

Este exemplo recupera o elemento badge do modelo e atribui a ele um valor numérico.



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

Este exemplo atribui um valor de glifo ao selo.



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

4. Crie a notificação e a envie para notificação.

Este exemplo empacota o XML definido em uma notificação e o envia para o selo.



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

5. Opcional: limpar o selo quando ele não for mais válido

Quando a informação passada pelo número ou glifo do selo estiver desatualizada ou não for mais útil, remova o selo. Quando a informação passada pelo número ou glifo do selo estiver desatualizada ou não for mais útil, remova o selo. Você também pode enviar o valor "nenhum" como uma atualização de notificação no lugar de chamar o método Limpar.

Observação  Diferentemente dos blocos, uma notificação pode ser apagada na nuvem.



BadgeUpdateManager.CreateBadgeUpdaterForApplication().Clear();

Resumo e próximas etapas

Neste Guia de início rápido, você definiu e enviou um novo conteúdo ao selo no bloco de seu aplicativo e o removeu depois que não era mais válido.

Este Guia de início rápido enviou a atualização de selo como uma notificação local. Você também pode explorar os outros métodos de entrega de notificações: agendadas, periódicas e por push. Para saber mais, veja Entregando notificações.

Tópicos relacionados

Visão geral das notificações
Esquema de selos
Como configurar notificações periódicas para selos
BadgeTemplateType
BadgeNotification

 

 

Mostrar:
© 2014 Microsoft