Partilhar via

Início Rápido: enviando uma notificação toast a partir do ambiente de trabalho

Este guia de início rápido mostra como exibir uma notificação de brinde de um aplicativo da área de trabalho.

Pré-requisitos

Instruções

1. Crie o seu conteúdo da notificação

Observação

Ao especificar um modelo de toast que inclua uma ilustração, lembre-se de que os aplicativos da área de trabalho podem usar apenas ilustrações locais; ilustrações da web não são suportadas. 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. Crie e anexe os manipuladores de eventos

Registrar manipuladores para os eventos do sistema: Ativado, Dispensado e Falhado. Um programa de área de trabalho deve pelo menos subscrever-se ao evento Activated para poder gerir a ativação prevista da aplicação a partir da notificação interativa quando o utilizador a seleciona.

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

3. Envie o brinde

Importante

Você deve incluir o AppUserModelID do atalho do seu aplicativo no ecrã inicial sempre que chamar CreateToastNotifier. Se não fizeres isso, a tua mensagem toast não será exibida.

 

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

4. Lidar com os retornos de chamada

Coloque a janela do seu aplicativo em primeiro plano se ela receber uma chamada "ativada" da notificação toast. 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.

Exemplo de envio de notificações 'toast' a partir de apps de ambiente de trabalho

Como habilitar notificações de toast da área de trabalho através de um AppUserModelID

Esquema XML de Toast

Visão geral da notificação de 'toast'

Início rápido: enviando uma notificação de alerta

Início Rápido: enviando uma notificação toast

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

Como escolher e usar um template de toast

Como lidar com a ativação de uma notificação tipo toast

Como ativar notificações toast

Escolhendo um modelo de toast

Opções de áudio de notificações

 

 

  • Last updated on