重新想象 Windows 8 Store Apps (35) - 通知: Toast 详解

[源码下载]

[align=center]重新想象 Windows 8 Store Apps (35) - 通知: Toast 详解[/align]

作者：webabcd

介绍
重新想象 Windows 8 Store Apps 之 通知

Toast - 基本应用参见 http://www.cnblogs.com/webabcd/archive/2013/06/17/3139740.html
Toast - 纯文本 toast

Toast - 图文 toast

Toast - toast 的提示音

Toast - 按计划弹出 toast

示例
1、演示纯文本 toast 的 4 个模板
Notification/Toast/ToastWithText.xaml

<Page
x:Class="XamlDemo.Notification.Toast.ToastWithText"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:XamlDemo.Notification.Toast"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">

<Grid Background="Transparent">
<StackPanel Margin="120 0 0 0">

<TextBox Name="lblMsg" Height="100" TextWrapping="Wrap" AcceptsReturn="True" FontSize="14.667" Margin="0 0 10 0" />

<Button Name="btnTextBodyWrap" Content="TextBodyWrap" Click="btnTextBodyWrap_Click_1" Margin="0 10 0 0" />

<Button Name="bntTextHeadingTextBodyWrap" Content="TextHeading TextBodyWrap" Click="bntTextHeadingTextBodyWrap_Click_1" Margin="0 10 0 0" />

<Button Name="bntTextHeadingWrapTextBody" Content="TextHeadingWrap TextBody" Click="bntTextHeadingWrapTextBody_Click_1" Margin="0 10 0 0" />

<Button Name="bntTextHeadingTextBody" Content="TextHeading TextBody1 TextBody2" Click="bntTextHeadingTextBody_Click_1" Margin="0 10 0 0" />

</StackPanel>
</Grid>
</Page>

Notification/Toast/ToastWithText.xaml.cs

/*
* 演示纯文本 toast 的 4 个模板
* 本示例的 Toast 的 XmlDocument 内容构造器采用一个开源项目，具体代码见：NotificationsExtensions/ToastContent.cs
*
* XmlDocument GetTemplateContent(ToastTemplateType type) - 获取系统支持的 Toast 模板
*     ToastTemplateType.ToastText01, ToastTemplateType.ToastText02, ToastTemplateType.ToastText03, ToastTemplateType.ToastText04
*/

using NotificationsExtensions.ToastContent;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace XamlDemo.Notification.Toast
{
public sealed partial class ToastWithText : Page
{
public ToastWithText()
{
this.InitializeComponent();
}

private void btnTextBodyWrap_Click_1(object sender, RoutedEventArgs e)
{
IToastText01 templateContent = ToastContentFactory.CreateToastText01();
templateContent.TextBodyWrap.Text = "我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}

private void bntTextHeadingTextBodyWrap_Click_1(object sender, RoutedEventArgs e)
{
IToastText02 templateContent = ToastContentFactory.CreateToastText02();
templateContent.TextHeading.Text = "我是通知标题，不可以换行。我是通知标题，不可以换行。";
templateContent.TextBodyWrap.Text = "我是通知正文，可换行，最多两行。我是通知正文，可换行，最多两行。";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}

private void bntTextHeadingWrapTextBody_Click_1(object sender, RoutedEventArgs e)
{
IToastText03 templateContent = ToastContentFactory.CreateToastText03();
templateContent.TextHeadingWrap.Text = "我是通知标题，可换行，最多两行。我是通知标题，可换行，最多两行。";
templateContent.TextBody.Text = "我是通知正文，不可以换行。我是通知正文，不可以换行。";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}

private void bntTextHeadingTextBody_Click_1(object sender, RoutedEventArgs e)
{
IToastText04 templateContent = ToastContentFactory.CreateToastText04();
templateContent.TextHeading.Text = "我是通知标题，不可以换行。我是通知标题，不可以换行。";
templateContent.TextBody1.Text = "我是通知正文1，不可以换行。我是通知正文1，不可以换行。";
templateContent.TextBody2.Text = "我是通知正文2，不可以换行。我是通知正文2，不可以换行。";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}
}
}

2、演示图文 toast 的 4 个模板
Notification/Toast/ToastWithImageText.xaml

<Page
x:Class="XamlDemo.Notification.Toast.ToastWithImageText"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:XamlDemo.Notification.Toast"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">

<Grid Background="Transparent">
<StackPanel Margin="120 0 0 0">

<TextBox Name="lblMsg" Height="100" TextWrapping="Wrap" AcceptsReturn="True" FontSize="14.667" Margin="0 0 10 0" />

<Button Name="btnTextBodyWrap" Content="TextBodyWrap" Click="btnTextBodyWrap_Click_1" Margin="0 10 0 0" />

<Button Name="bntTextHeadingTextBodyWrap" Content="TextHeading TextBodyWrap" Click="bntTextHeadingTextBodyWrap_Click_1" Margin="0 10 0 0" />

<Button Name="bntTextHeadingWrapTextBody" Content="TextHeadingWrap TextBody" Click="bntTextHeadingWrapTextBody_Click_1" Margin="0 10 0 0" />

<Button Name="bntTextHeadingTextBody" Content="TextHeading TextBody1 TextBody2" Click="bntTextHeadingTextBody_Click_1" Margin="0 10 0 0" />

</StackPanel>
</Grid>
</Page>

Notification/Toast/ToastWithImageText.xaml.cs

/*
* 演示图文 toast 的 4 个模板（注：图片不能大于 1024*1024 像素，不能大于 200KB）
* 本示例的 Toast 的 XmlDocument 内容构造器采用一个开源项目，具体代码见：NotificationsExtensions/ToastContent.cs
*
* XmlDocument GetTemplateContent(ToastTemplateType type) - 获取系统支持的 Toast 模板
*     ToastTemplateType.ToastImageAndText01, ToastTemplateType.ToastImageAndText02, ToastTemplateType.ToastImageAndText03, ToastTemplateType.ToastImageAndText04
*
* 注：图片可以来自程序包内，可以来自 Application Data（仅支持对 local 中图片文件的引用），可以来自一个 http 的远程地址
*/

using NotificationsExtensions.ToastContent;
using System;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;

namespace XamlDemo.Notification.Toast
{
public sealed partial class ToastWithImageText : Page
{
public ToastWithImageText()
{
this.InitializeComponent();
}

private void btnTextBodyWrap_Click_1(object sender, RoutedEventArgs e)
{
IToastImageAndText01 templateContent = ToastContentFactory.CreateToastImageAndText01();
templateContent.TextBodyWrap.Text = "我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。";
templateContent.Image.Src = "Assets/Logo.png"; // 用程序包内文件作通知图片
templateContent.Image.Alt = "altText";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}

private void bntTextHeadingTextBodyWrap_Click_1(object sender, RoutedEventArgs e)
{
IToastImageAndText02 templateContent = ToastContentFactory.CreateToastImageAndText02();
templateContent.TextHeading.Text = "我是通知标题，不可以换行。我是通知标题，不可以换行。";
templateContent.TextBodyWrap.Text = "我是通知正文，可换行，最多两行。我是通知正文，可换行，最多两行。";
templateContent.Image.Src = "ms-appx:///Assets/Logo.png"; // 用程序包内文件作通知图片
templateContent.Image.Alt = "altText";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}

private void bntTextHeadingWrapTextBody_Click_1(object sender, RoutedEventArgs e)
{
IToastImageAndText03 templateContent = ToastContentFactory.CreateToastImageAndText03();
templateContent.TextHeadingWrap.Text = "我是通知标题，可换行，最多两行。我是通知标题，可换行，最多两行。";
templateContent.TextBody.Text = "我是通知正文，不可以换行。我是通知正文，不可以换行。";
templateContent.Image.Src = "ms-appdata:///local/Logo.png"; // 用 Application Data 内文件作通知图片（注：仅支持 local 中的图片）
templateContent.Image.Alt = "altText";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}

private void bntTextHeadingTextBody_Click_1(object sender, RoutedEventArgs e)
{
IToastImageAndText04 templateContent = ToastContentFactory.CreateToastImageAndText04();
templateContent.TextHeading.Text = "我是通知标题，不可以换行。我是通知标题，不可以换行。";
templateContent.TextBody1.Text = "我是通知正文1，不可以换行。我是通知正文1，不可以换行。";
templateContent.TextBody2.Text = "我是通知正文2，不可以换行。我是通知正文2，不可以换行。";
templateContent.Image.Src = "http://pic.cnblogs.com/avatar/a14540.jpg?id=24173245"; // 用远程文件作通知图片
templateContent.Image.Alt = "altText";
IToastNotificationContent toastContent = templateContent;

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}
}
}

3、演示 Toast 的提示音
Notification/Toast/ToastWithSound.xaml

<Page
x:Class="XamlDemo.Notification.Toast.ToastWithSound"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:XamlDemo.Notification.Toast"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">

<Grid Background="Transparent">
<StackPanel Margin="120 0 0 0">

<TextBox Name="lblMsg" Height="100" TextWrapping="Wrap" AcceptsReturn="True" FontSize="14.667" Margin="0 0 10 0" />

<TextBlock Text="通知提示音列表" Margin="0 10 0 0" />
<ListBox Name="listBox" SelectionChanged="listBox_SelectionChanged_1" Margin="0 10 10 0">
<ListBoxItem Content="Default" />
<ListBoxItem Content="Mail" />
<ListBoxItem Content="SMS" />
<ListBoxItem Content="IM" />
<ListBoxItem Content="Reminder" />
<ListBoxItem Content="LoopingCall" />
<ListBoxItem Content="LoopingCall2" />
<ListBoxItem Content="LoopingAlarm" />
<ListBoxItem Content="LoopingAlarm2" />
<ListBoxItem Content="Silent" />
</ListBox>
</StackPanel>
</Grid>
</Page>

Notification/Toast/ToastWithSound.xaml.cs

/*
* 演示 Toast 的提示音
*
* 目前支持的 Toast 提示音共有以下几种：
* Default, Mail, SMS, IM, Reminder, LoopingCall, LoopingCall2, LoopingAlarm, LoopingAlarm2, Silent
*/

using NotificationsExtensions.ToastContent;
using System;
using Windows.UI.Notifications;
using Windows.UI.Xaml.Controls;

namespace XamlDemo.Notification.Toast
{
public sealed partial class ToastWithSound : Page
{
public ToastWithSound()
{
this.InitializeComponent();
}

private void listBox_SelectionChanged_1(object sender, SelectionChangedEventArgs e)
{
string audioType = (listBox.SelectedItem as ListBoxItem).Content.ToString();

IToastText02 toastContent = ToastContentFactory.CreateToastText02();
toastContent.TextHeading.Text = "Sound:";
toastContent.TextBodyWrap.Text = audioType;
toastContent.Audio.Content = (ToastAudioContent)Enum.Parse(typeof(ToastAudioContent), audioType);

/*
* LoopingCall, LoopingCall2, LoopingAlarm, LoopingAlarm2 这 4 种提示音仅针对长时通知，且需指定为循环提示音
*/
if (audioType == "LoopingCall" || audioType == "LoopingCall2" || audioType == "LoopingAlarm" || audioType == "LoopingAlarm2")
{
toastContent.Duration = ToastDuration.Long;
toastContent.Audio.Loop = true;
}

ToastNotification toast = toastContent.CreateNotification();
ToastNotificationManager.CreateToastNotifier().Show(toast);

lblMsg.Text = toastContent.GetContent();
}
}
}

4、演示如何按计划显示 Toast 通知
Notification/Toast/ScheduledToast.xaml

<Page
x:Class="XamlDemo.Notification.Toast.ScheduledToast"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:XamlDemo.Notification.Toast"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d">

<Grid Background="Transparent">
<StackPanel Margin="120 0 0 0">

<!--显示当前 app 的全部 ScheduledToastNotification 对象列表-->
<ListBox Name="listBox" Width="800" Height="300" HorizontalAlignment="Left">
<ListBox.ItemTemplate>
<DataTemplate>
<StackPanel Orientation="Horizontal">
<TextBlock Text="{Binding ToastId}" VerticalAlignment="Center" />
<TextBlock Text="{Binding Text}" Margin="15 0 0 0" VerticalAlignment="Center" />
<HyperlinkButton Name="btnRemove" Content="删除此 ScheduledToastNotification" Tag="{Binding ToastId}" Margin="15 0 0 0" Click="btnRemove_Click_1" />
</StackPanel>
</DataTemplate>
</ListBox.ItemTemplate>
</ListBox>

<Button Name="btnScheduledToast" Content="ScheduledToastNotification 的 Demo（3 秒后弹出 Toast 通知，然后每隔 60 秒再弹出一次，共重复 5 次）" Click="btnScheduledToast_Click_1" Margin="0 10 0 0" />

</StackPanel>
</Grid>
</Page>

Notification/Toast/ScheduledToast.xaml.cs

/*
* 演示如何按计划显示 Toast 通知
*
* ScheduledToastNotification - 按计划显示 Toast 通知
*     Content - Toast 的内容，XmlDocument 类型的数据，只读，其需要在构造函数中指定
*     DeliveryTime - 显示 Toast 通知的时间，只读，其需要在构造函数中指定
*     SnoozeInterval - 循环显示 Toast 通知的间隔时长（60 秒 - 60 分之间），只读，其需要在构造函数中指定
*     MaximumSnoozeCount - 循环的最大次数（1 - 5 次）
*     Id - ScheduledToastNotification 的标识
*
* ToastNotifier - Toast 通知器
*     AddToSchedule() - 将指定的 ScheduledToastNotification 添加到计划列表
*     RemoveFromSchedule() - 从计划列表中移除指定的 ScheduledToastNotification
*     GetScheduledToastNotifications() - 获取当前 app 的全部 ScheduledToastNotification 集合
*/

using NotificationsExtensions.ToastContent;
using System;
using System.Collections.Generic;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Navigation;

namespace XamlDemo.Notification.Toast
{
public sealed partial class ScheduledToast : Page
{
public ScheduledToast()
{
this.InitializeComponent();
}

protected override void OnNavigatedTo(NavigationEventArgs e)
{
ShowScheduledToasts();
}

// 添加指定的 ScheduledToastNotification 到计划列表中
private void btnScheduledToast_Click_1(object sender, RoutedEventArgs e)
{
IToastText02 toastContent = ToastContentFactory.CreateToastText02();
toastContent.TextHeading.Text = "ScheduledToastNotification Demo";
toastContent.TextBodyWrap.Text = "received: " + DateTime.Now.ToString("hh:mm:ss");

// 3 秒后显示 Toast，然后每隔 60 秒再显示一次 Toast（循环显示 5 次）
ScheduledToastNotification toast = new ScheduledToastNotification(toastContent.GetXml(), DateTime.Now.AddSeconds(3), TimeSpan.FromSeconds(60), 5);

string toastId = new Random().Next(1000, 10000).ToString();
toast.Id = toastId;

// 将指定的 ScheduledToastNotification 添加进计划列表
ToastNotifier toastNotifier = ToastNotificationManager.CreateToastNotifier();
toastNotifier.AddToSchedule(toast);

ShowScheduledToasts();
}

// 显示当前 app 的全部 ScheduledToastNotification 列表
private void ShowScheduledToasts()
{
List<MyScheduledToast> dataSource = new List<MyScheduledToast>();

// 获取当前 app 计划列表中的全部 ScheduledToastNotification 对象列表
ToastNotifier toastNotifier = ToastNotificationManager.CreateToastNotifier();
IReadOnlyList<ScheduledToastNotification> scheduledToasts = toastNotifier.GetScheduledToastNotifications();

int toastCount = scheduledToasts.Count;
for (int i = 0; i < toastCount; i++)
{
ScheduledToastNotification toast = scheduledToasts[i];

dataSource.Add(new MyScheduledToast()
{
ToastId = toast.Id,
Text = toast.Content.GetElementsByTagName("text")[0].InnerText
});
}

listBox.ItemsSource = dataSource;
}

// 根据 ToastId 删除指定的 ScheduledToastNotification
private void btnRemove_Click_1(object sender, RoutedEventArgs e)
{
string toastId = (string)(sender as FrameworkElement).Tag;

// 获取当前 app 计划列表中的全部 ScheduledToastNotification 对象列表
ToastNotifier toastNotifier = ToastNotificationManager.CreateToastNotifier();
IReadOnlyList<ScheduledToastNotification> scheduledToasts = toastNotifier.GetScheduledToastNotifications();

int toastLength = scheduledToasts.Count;
for (int i = 0; i < toastLength; i++)
{
if (scheduledToasts[i].Id == toastId)
{
// 从计划列表中移除指定的 ScheduledToastNotification 对象
toastNotifier.RemoveFromSchedule(scheduledToasts[i]);

ShowScheduledToasts();

break;
}
}
}

class MyScheduledToast
{
public string ToastId { get; set; }
public string Text { get; set; }
}
}
}

OK
[源码下载]