快速构建Windows 8风格应用34-构建Toast通知

原文:快速构建Windows 8风格应用34-构建Toast通知

快速构建Windows 8风格应用34-构建Toast通知

引言

开发过WindowsPhone应用或者使用过WindowsPhone手机的开发者都知道,我们会收到一些应用的提示信息,这些提示信息出现在手机的上端,并且停留几秒钟后会自动消失,当然如果我们点击弹出的信息会自动运行相应的应用程序,这种提示信息我们叫做通知。

其实Windows 8 Store 应用也借鉴了Windows Phone上的提示信息,我们开发人员可以使自己应用程序在合适时间弹出相关提示信息,那么这些Windows 8 Store应用的提示信息,我们叫做Toast通知。

并且Toast通知样式可以自定义的。例如:

快速构建Windows 8风格应用34-构建Toast通知

一、Toast通知概述

Toast 通知是在屏幕右上角(对于从右到左 (Right-To-Left) 方向位于左上角)显示的通知。

  • Toast 通知可在应用上下文之外提供临时消息
  • 用 toast 通知可立即吸引用户注意
  • 用户可以永久关闭应用的 toast 通知
  • 能够快速导航到应用中上下文相关的位置
  • 很容易从应用本地或云端调用 toast 通知

Toast 通知使用与动态磁贴类似的模板架构体系,有丰富的展现形式可以选择。

快速构建Windows 8风格应用34-构建Toast通知

更多关于Toast 通知概述可以参考:Toast 通知概述(Windows 应用商店应用) (Windows)

二、Toast通知构建

1,声明Toast通知功能

打开Package.appxmanifest应用清单文件,“应用程序UI”选项卡中找到“支持Toast通知”设置为“是”。

快速构建Windows 8风格应用34-构建Toast通知

2,声明 Toast 通知背景色和文本颜色

我们可以为 Toast 通知设置背景颜色和浅色或深色文本。注意:该设置同时适用Toast 和磁贴通知背景以及文本颜色。

快速构建Windows 8风格应用34-构建Toast通知

3,指定小徽标图像

应用的小徽标图像显示在每个 Toast 通知的右下角,让用户识别引发通知的应用。

快速构建Windows 8风格应用34-构建Toast通知

4,添加命名空间声明

   1:  using Windows.UI.Notifications;
   2:  using Windows.Data.Xml.Dom;

5,为 Toast 选取一个模板并检索其 XML 内容

我们从系统提供的模板目录中选择一个适合的模板(详细的模板列表可参考 ToastTemplateType 枚举)。

注意:我们发送的每个单独的通知都可以使用不同的模板。

   1:  ToastTemplateType toastTemplate = ToastTemplateType.ToastImageAndText01; 
   2:  XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(toastTemplate);

这里我使用的是ToastImageAndText01 模板,该模版样式如下:

快速构建Windows 8风格应用34-构建Toast通知

6,为通知提供文本内容

我们可以首先检索模板中标记名称为“text”的所有元素。

ToastImageAndText01 模板只包含一个代码分配的文本字符串。该字符串最多可包含三行自动换行的字符串,因此我们应该相应地设置字符串的长度,以避免被截断。

   1:  XmlNodeList toastTextElements = toastXml.GetElementsByTagName("text");
   2:   toastTextElements[0].AppendChild(toastXml.CreateTextNode("你好Windows 8!"));

7,为通知提供图像

我们可以首先检索模板中标记名称为“image”的所有元素。

与磁贴不同,Toast 模板(如 ToastImageAndText01)最多包含一个图像。

注意:并非所有 Toast 模板都包含图像,某些磁贴模板是仅文本的。

   1:  XmlNodeList toastImageAttributes = toastXml.GetElementsByTagName("image");

然后我们可以从应用的程序包、本地存储或从 Web 使用图像。注意:该图像大小小于 200 KB,小于 1024 x 1024 像素。

这里我以应用程序包的图像为例:

   1:  ((XmlElement)toastImageAttributes[0]).SetAttribute("src", "ms-appx:///Assets/SmallLogo.png");
   2:  ((XmlElement)toastImageAttributes[0]).SetAttribute("alt", "red graphic");

8,指定Toast 持续时间或者Toast 音频(非必要)

我们可以为Toast设置持续时间(仅有两个值:short和long),通常当我们的通知属于约会或者会议提醒之类的时候才使用“long”值。

注意:Toast持续时间默认为“short”。

   1:  IXmlNode toastNode = toastXml.SelectSingleNode("/toast");
   2:  ((XmlElement)toastNode).SetAttribute("duration", "long");

另外我们也可以设置Toast音频,默认情况下Windows在播放通知时会播放一个简短的声音。同时我们可以选择使用系统提供的声音,也可以不使用任何声音。

由于模板中不包含 audio 元素,因此我们必须定义该元素,同时使用“ms-winsoundevent:”前缀指定声音文件。

   1:  IXmlNode toastNode = toastXml.SelectSingleNode("/toast");                        
   2:  XmlElement audio = toastXml.CreateElement("audio");

指定非默认声音。

   1:  audio.SetAttribute("src", "ms-winsoundevent:Notification.IM");

定义 audio 元素之后,需要将其附加到 Toast 的 XML 负载中,作为 toast 元素的子元素。

   1:  toastNode.AppendChild(audio);

9,指定应用的启动参数

通常用户点击 Toast 通知时,相关应用应当会启动,并显示与该通知的内容相关的视图。

我们可以使用 Toast 元素的 launch 属性来实现该效果。

该属性提供一个在通过 Toast 启动应用时,从 Toast 传递到应用的字符串。此字符串没有任何特定形式,它由我们应用来定义。

我们的应用在每次被激活时必须检查作为参数形式的此字符串,并相应地调整它的视图或操作。例如:

   1:  ((XmlElement)toastNode).SetAttribute("launch", "{\"type\":\"toast\",\"param1\":\"12345\",\"param2\":\"67890\"}");

10,创建 Toast 通知并发送

   1:  ToastNotification toast = new ToastNotification(toastXml);
   2:  ToastNotificationManager.CreateToastNotifier().Show(toast);

最后运行效果可如下:

快速构建Windows 8风格应用34-构建Toast通知

点击按钮后弹出Toast通知:

快速构建Windows 8风格应用34-构建Toast通知

 

更多关于Toast通知资料可参考:

1,发送 Toast 通知(使用 C#/VB/C++ 和 XAML 的 Windows 应用商店应用) (Windows)

2,Toast notifications sample

上一篇:Spark学习[扩展阅读] 详解 Spark RDD


下一篇:新版 Win 10 针对中国市场,改善简体中文输入体验