Compartilhar via

Início Rápido: Enviando uma notificação do sistema da área de trabalho

  • Artigo

Este início rápido mostra como gerar uma notificação do sistema de um aplicativo da área de trabalho.

Pré-requisitos

Instruções

1. Criar seu conteúdo do sistema

Observação

Ao especificar um modelo do sistema que inclui uma imagem, lembre-se de que os aplicativos da área de trabalho podem usar apenas imagens locais; não há suporte para imagens da Web. Além disso, o caminho para o arquivo de imagem local deve ser fornecido como um caminho absoluto (não relativo).

 

// Get a toast XML template
XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastImageAndText04);

// Fill in the text elements
XmlNodeList stringElements = toastXml.GetElementsByTagName("text");
for (int i = 0; i < stringElements.Length; i++)
{
    stringElements[i].AppendChild(toastXml.CreateTextNode("Line " + i));
}

// Specify the absolute path to an image
String imagePath = "file:///" + Path.GetFullPath("toastImageAndText.png");
XmlNodeList imageElements = toastXml.GetElementsByTagName("image");

ToastNotification toast = new ToastNotification(toastXml);

2. Criar e anexar os manipuladores de eventos

Registre manipuladores para os eventos do sistema: Ativado, Ignorado e Com Falha. Um aplicativo da área de trabalho deve pelo menos assinar o evento Ativado para que ele possa lidar com a ativação esperada do aplicativo no sistema quando o usuário o selecionar.

toast.Activated += ToastActivated;
toast.Dismissed += ToastDismissed;
toast.Failed += ToastFailed;

3. Enviar a notificação do sistema

Importante

Você deve incluir o AppUserModelID do atalho do aplicativo na tela inicial sempre que chamar CreateToastNotifier. Se você não fizer isso, o sistema não será exibido.

 

ToastNotificationManager.CreateToastNotifier(appID).Show(toast);

4. Manipular os retornos de chamada

Coloque a janela do aplicativo em primeiro plano se ele receber um retorno de chamada "ativado" da notificação do sistema. Quando um usuário seleciona uma notificação do sistema, a expectativa é que o aplicativo seja iniciado para uma exibição relacionada ao conteúdo dessa notificação do sistema.

Exemplo de envio de notificações do sistema de aplicativos da área de trabalho

Como habilitar notificações do sistema de área de trabalho por meio de um AppUserModelID

Esquema XML do sistema

Visão geral da notificação do sistema

Início Rápido: Enviar uma notificação do sistema

Início Rápido: Enviar uma notificação por push do sistema

Diretrizes e lista de verificação para notificações do sistema

Como escolher e usar um modelo do sistema

Como lidar com a ativação de uma notificação do sistema

Como aceitar notificações do sistema

Escolhendo um modelo do sistema

Opções de áudio do sistema