Share via

快速入门：从桌面发送 Toast 通知

  • 项目

本快速入门介绍如何从桌面应用引发 Toast 通知。

先决条件

Instructions

1. 创建 Toast 内容

注意

指定包含图像的 Toast 模板时，请注意桌面应用只能使用本地映像;不支持 Web 映像。 此外，本地映像文件的路径必须作为绝对 (而不是相对) 路径提供。

 

// 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.创建并附加事件处理程序

注册 Toast 事件的处理程序：Activated、Dismissed 和 Failed。 桌面应用必须至少订阅 Activated 事件，以便它可以处理用户选择该应用时从 Toast 中预期激活的应用。

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

3. 发送 toast

重要

每次调用 CreateToastNotifier 时，都必须在“开始”屏幕上包含应用快捷方式的 AppUserModelID。 如果未能执行此操作，则不会显示你的 Toast。

 

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

4. 处理回调

如果应用从 Toast 通知收到“已激活”回调，请将应用窗口带到前台。 当用户选择 Toast 时，预期应用将启动到与该 Toast 内容相关的视图。

从桌面应用发送 toast 通知示例

如何通过 AppUserModelID 启用桌面 toast 通知

Toast XML 架构

Toast 通知概述

快速入门：发送 Toast 通知

快速入门：发送 Toast 推送通知

Toast 通知指南和清单

如何选择和使用 Toast 模板

如何处理 Toast 通知中的激活

如何选择加入 Toast 通知

选择 Toast 模板

Toast 音频选项