必须在“开始”屏幕中安装带有
System.AppUserModel.ID
的应用快捷方式。 但请注意,它不需要固定到“开始”屏幕。 有关详细信息,请参阅
如何通过 AppUserModelID 启用桌面 Toast 通知
。
至少支持 Windows 8 的 Microsoft Visual Studio 版本
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 音频选项