重新想象 Windows 8 Store Apps (34)

zxg588

　　[源码下载]




重新想象 Windows 8 Store Apps (34) - 通知: Toast Demo, Tile Demo, Badge Demo　　
作者：webabcd

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

• Toast - 通知的应用
  
• Tile - 瓷贴的应用
  
• Badge - 徽章的应用
  
• Badge - 轮询服务端以更新 Badge 通知
  

　　
示例
1、演示 toast 的基本应用
Notification/Toast/Demo.xaml













　　Notification/Toast/Demo.xaml.cs



/*
* Toast - 通知
*
* ToastNotification - Toast 通知
*     Content - Toast 的内容，XmlDocument 类型的数据，只读，其需要在构造函数中指定
*     ExpirationTime - Toast 通知的过期时间，即如果系统在此属性指定的时间到了之后还没有显示对应的 Toast 通知，那么之后也不要再显示了
*     Activated - 用户点击通知时触发的事件
*     Dismissed - 通知消失时触发的事件（事件参数 ToastDismissedEventArgs）
*     Failed - 通知显示失败时触发的事件
*     
* ToastDismissedEventArgs - Toast 消失时的事件参数
*     Reason - 通知消失的原因（Windows.UI.Notifications.ToastDismissalReason 枚举）
*         UserCanceled - 用户关闭通知
*         ApplicationHidden - 通过 ToastNotifier.Hide() 关闭通知
*         TimedOut - 自动关闭通知（短通知 7 秒，长通知 25 秒）
*         
* ToastNotificationManager - Toast 通知管理器
*     CreateToastNotifier() - 创建一个 Toast 通知器，返回 ToastNotifier 类型的数据
*     CreateToastNotifier(string applicationId) - 为指定的 app 创建一个 Toast 通知器（这里指定的是同一 package 内的其他 app 。注：一个 package 中可以有多个 app，但是目前无法通过商店审核）
*     
* ToastNotifier - Toast 通知器
*     Show() - 显示指定的 ToastNotification
*     Hide() - 隐藏指定的 ToastNotification
*     Setting - 获取通知设置（Windows.UI.Notifications.NotificationSetting 枚举）
*         Enabled - 通知可被显示
*         DisabledForApplication - 用户禁用了此应用程序的通知
*         DisabledForUser - 用户禁用了此计算机此账户的所有通知
*         DisabledByGroupPolicy - 管理员通过组策略禁止了此计算机上的所有通知
*         DisabledByManifest - 应用程序未在 Package.appxmanifest 中启用 Toast 通知（对应“应用程序 UI”中的小徽标）
*         
*
* 注：
* 目前系统支持 8 套 Toast 模板：详见：ToastWithText.xaml 和 ToastWithImageText.xaml
* Toast 通知右下角的应用程序徽标，采用的是 Package.appxmanifest 中配置的小徽标，即 30*30 像素的徽标
* 不能在模拟器中运行
*/
using NotificationsExtensions.ToastContent;
using System;
using Windows.Data.Xml.Dom;
using Windows.UI.Core;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
namespace XamlDemo.Notification.Toast
{
public sealed partial class Demo : Page
{
public Demo()
{
this.InitializeComponent();
}
// 弹出短时通知
private void btnShortToast_Click_1(object sender, RoutedEventArgs e)
{
// 用一个开源的 Toast 构造器来创建 ToastNotification，具体实现参见：NotificationsExtensions/ToastContent.cs
IToastText01 templateContent = ToastContentFactory.CreateToastText01();
templateContent.TextBodyWrap.Text = "我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。";
templateContent.Duration = ToastDuration.Short; // 短时通知，默认值
// 当后台弹出 toast 时，用户点击了 toast 后，可以通过 OnLaunched() 中的 args.Arguments 来获取此处 Launch 指定的值
templateContent.Launch = "param";
IToastNotificationContent toastContent = templateContent;
ToastNotification toast = toastContent.CreateNotification();
// 监听 ToastNotification 的相关事件
toast.Activated += toast_Activated;
toast.Failed += toast_Failed;
toast.Dismissed += toast_Dismissed;
// 弹出指定的通知
ToastNotifier toastNotifier = ToastNotificationManager.CreateToastNotifier();
toastNotifier.Show(toast);
lblStatus.Text += "NotificationSetting: " + toastNotifier.Setting.ToString();
lblStatus.Text += Environment.NewLine;
// 显示此 toast 的 xml
lblMsg.Text = toastContent.GetContent();
}
// 弹出长时通知
private void btnLongToast_Click_1(object sender, RoutedEventArgs e)
{
// 手工构造 Toast 通知的 xml
var toastXmlString = ""
+ ""
+ ""
+ "我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。"
+ ""
+ ""
+ ""
+ "";
// 将字符串转换为 XmlDocument
XmlDocument toastDOM = new XmlDocument();
toastDOM.LoadXml(toastXmlString);
// 实例化 ToastNotification
ToastNotification toast = new ToastNotification(toastDOM);
// 监听 ToastNotification 的相关事件
toast.Activated += toast_Activated;
toast.Failed += toast_Failed;
toast.Dismissed += toast_Dismissed;
// 弹出指定的通知
ToastNotifier toastNotifier = ToastNotificationManager.CreateToastNotifier();
toastNotifier.Show(toast);
lblStatus.Text += "NotificationSetting: " + toastNotifier.Setting.ToString();
lblStatus.Text += Environment.NewLine;
// 显示此 toast 的 xml
lblMsg.Text = toastXmlString;
}
async void toast_Dismissed(ToastNotification sender, ToastDismissedEventArgs args)
{
await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
{
lblStatus.Text += "Toast.Dismissed: " + args.Reason.ToString();
lblStatus.Text += Environment.NewLine;
});
}
async void toast_Failed(ToastNotification sender, ToastFailedEventArgs args)
{
await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
{
lblStatus.Text += "Toast.Failed: " + args.ErrorCode.ToString();
lblStatus.Text += Environment.NewLine;
});
}
async void toast_Activated(ToastNotification sender, object args)
{
await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
{
lblStatus.Text += "Toast.Activated: " + sender.Content.GetXml();
lblStatus.Text += Environment.NewLine;
});
}
}
}
　　
2、演示 tile 的基本应用
Notification/Tile/Demo.xaml














　　Notification/Tile/Demo.xaml.cs



/*
* Tile - 瓷贴
*
* TileNotification - Tile 通知
*     Content - Tile 的内容，XmlDocument 类型的数据，只读，其需要在构造函数中指定
*     ExpirationTime - Tile 通知的过期时间，即如果系统在此属性指定的时间到了之后还没有更新对应的 Tile 通知，那么之后也不要再更新了
*     
* TileUpdateManager - Tile 更新管理器
*     CreateTileUpdaterForApplication() - 创建一个 Tile 更新器，返回 TileUpdater 类型的数据
*     CreateTileUpdaterForApplication(string applicationId) - 为指定的 app 创建一个 Tile 更新器（这里指定的是同一 package 内的其他 app 。注：一个 package 中可以有多个 app，但是目前无法通过商店审核）
*     XmlDocument GetTemplateContent(TileTemplateType type) - 获取系统支持的 Tile 模板，目前共有 46 种，详见：AllTemplates.xaml
*     
* TileUpdater - Tile 更新器
*     Update() - 更新指定的 TileNotification
*     Clear() - 清除 TileNotification，开始屏幕的 Tile 将显示 Package.appxmanifest 中配置的图片
*     Setting - 获取通知设置（Windows.UI.Notifications.NotificationSetting 枚举）
*         Enabled - 通知可被显示
*         DisabledForApplication - 用户禁用了此应用程序的通知
*         DisabledForUser - 用户禁用了此计算机此账户的所有通知
*         DisabledByGroupPolicy - 管理员通过组策略禁止了此计算机上的所有通知
*         DisabledByManifest - 应用程序未在 Package.appxmanifest 中启用 Tile 通知（对应“应用程序 UI”中的徽标和宽徽标）
*         
* 注：
* TileNotification 中引用的图片可以来自程序包内，可以来自 Application Data（仅支持对 local 中图片文件的引用），可以来自一个 http 的远程地址
* 即 ms-appx:/// 或 ms-appdata:///local/ 或 http:// 或 https://
* 图片不能大于 1024*1024 像素，不能大于 200KB
* 不能在模拟器中运行
*/
using NotificationsExtensions.TileContent;
using Windows.Data.Xml.Dom;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Navigation;
namespace XamlDemo.Notification.Tile
{
public sealed partial class Demo : Page
{
public Demo()
{
this.InitializeComponent();
}
// 通过手工方式构造 xml 模板，以更新 Tile
private void btnXmlTile_Click_1(object sender, RoutedEventArgs e)
{
// 手工构造 Tile 通知的 xml
string tileXmlString = ""
+ ""
+ ""
+ "hi webabcd"
+ ""
+ ""
+ "hi webabcd"
+ ""
+ ""
+ "";
// 将字符串转换为 XmlDocument
XmlDocument tileDOM = new Windows.Data.Xml.Dom.XmlDocument();
tileDOM.LoadXml(tileXmlString);
// 实例化 TileNotification
TileNotification tile = new TileNotification(tileDOM);
// 更新指定的 TileNotification
TileUpdater tileUpdater = TileUpdateManager.CreateTileUpdaterForApplication();
tileUpdater.Update(tile);
// 显示此 tile 的 xml
lblMsg.Text = tileDOM.GetXml();
lblStatus.Text = "NotificationSetting: " + tileUpdater.Setting.ToString();
}
// 通过模板帮助类更新 Tile
private void btnTemplateTile_Click_1(object sender, RoutedEventArgs e)
{
// 用一个开源的 Tile 构造器来创建 TileNotification，具体实现参见：NotificationsExtensions/TileContent.cs
// 构造小 tile 数据
ITileSquareImage squareContent = TileContentFactory.CreateTileSquareImage();
squareContent.Image.Src = "http://pic.iyunv.com/avatar/a14540.jpg?id=24173245";
squareContent.Image.Alt = "altText";
// 构造 tile 数据（包括大 tile 数据和小 tile 数据）
ITileWideImageAndText01 tileContent = TileContentFactory.CreateTileWideImageAndText01();
tileContent.TextCaptionWrap.Text = "hi webabcd";
tileContent.Image.Src = "http://pic.iyunv.com/avatar/a14540.jpg?id=24173245";
tileContent.Image.Alt = "altText";
tileContent.SquareContent = squareContent;
// 创建 TileNotification
TileNotification tile = tileContent.CreateNotification();
// 更新指定的 TileNotification
TileUpdater tileUpdater = TileUpdateManager.CreateTileUpdaterForApplication();
tileUpdater.Update(tile);
// 显示此 tile 的 xml
lblMsg.Text = tileContent.GetContent();
}
// 清除 Tile
private void btnClearTile_Click_1(object sender, RoutedEventArgs e)
{
TileUpdater tileUpdater = TileUpdateManager.CreateTileUpdaterForApplication();
tileUpdater.Clear();
}
}
}
　　
3、演示 badge 的基本应用
Notification/Badge/Demo.xaml












　　Notification/Badge/Demo.xaml.cs



/*
* Badge - 徽章
*
* BadgeNotification - Badge 通知
*     Content - Badge 的内容，XmlDocument 类型的数据，只读，其需要在构造函数中指定
*     
* BadgeUpdateManager - Badge 更新管理器
*     CreateBadgeUpdaterForApplication() - 创建一个 Badge 更新器，返回 BadgeUpdater 类型的数据
*     CreateBadgeUpdaterForSecondaryTile(string tileId) - 为指定的 SecondaryTile 创建一个 Badge 更新器，返回 BadgeUpdater 类型的数据
*     CreateBadgeUpdaterForApplication(string applicationId) - 为指定的 app 创建一个 Badge 更新器（这里指定的是同一 package 内的其他 app 。注：一个 package 中可以有多个 app，但是目前无法通过商店审核）
*     XmlDocument GetTemplateContent(BadgeTemplateType type) - 获取系统支持的 Badge 模板（BadgeGlyph 和 BadgeNumber）
*     
* BadgeUpdater - Badge 更新器
*     Update() - 更新指定的 BadgeNotification
*     Clear() - 清除 BadgeNotification
*/
using NotificationsExtensions.BadgeContent;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Navigation;
namespace XamlDemo.Notification.Badge
{
public sealed partial class Demo : Page
{
public Demo()
{
this.InitializeComponent();
}
// 以数字的方式更新 Badge
private void btnUpdateBadgeWidthNumber_Click_1(object sender, RoutedEventArgs e)
{
// 用一个开源的 Badge 构造器来创建 BadgeNotification，具体实现参见：NotificationsExtensions/BadgeContent.cs
// 数字在 1 - 99 之间（如果大于 99 则会显示 99+ ，如果是 0 则会移除 Badge）
BadgeNumericNotificationContent badgeContent = new BadgeNumericNotificationContent(107);
// 创建 BadgeNotification
BadgeNotification badge = badgeContent.CreateNotification();
// 更新指定的 BadgeNotification
BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForApplication();
badgeUpdater.Update(badge);
// 显示此 Badge 的 xml
lblMsg.Text = badgeContent.GetContent();
}
// 以图标的方式更新 Badge
private void btnUpdateBadgeWidthIcon_Click_1(object sender, RoutedEventArgs e)
{
// 用一个开源的 Badge 构造器来创建 BadgeNotification，具体实现参见：NotificationsExtensions/BadgeContent.cs
// 图标类型共有 12 种，分别是：None, Activity, Alert, Available, Away, Busy, NewMessage, Paused, Playing, Unavailable, Error, Attention
BadgeGlyphNotificationContent badgeContent = new BadgeGlyphNotificationContent(GlyphValue.NewMessage);
// 创建 BadgeNotification
BadgeNotification badge = badgeContent.CreateNotification();
// 更新指定的 BadgeNotification
BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForApplication();
badgeUpdater.Update(badge);
// 显示此 Badge 的 xml
lblMsg.Text = badgeContent.GetContent();
}
}
}
　　
4、演示如何轮询服务端以更新 Badge 通知
Notification/Badge/ScheduledBadge.xaml










　　Notification/Badge/ScheduledBadge.xaml.cs



/*
* 演示如何定时更新 Badge 通知
*
* BadgeUpdater - Badge 更新器
*     StartPeriodicUpdate(Uri badgeContent, DateTimeOffset startTime, PeriodicUpdateRecurrence requestedInterval) - 启动一个“轮询服务端，而后更新 Badge”的任务
*         badgeContent - Badge 通知的内容（xml 格式数据）的 uri 地址
*         startTime - 可以指定启动此任务的时间
*         requestedInterval - 轮询服务端的周期（Windows.UI.Notifications.PeriodicUpdateRecurrence 枚举）
*             HalfHour, Hour, SixHours, TwelveHours, Daily
*     StopPeriodicUpdate() - 停止“轮询服务端，而后更新 Badge”的任务
*/
using System;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
namespace XamlDemo.Notification.Badge
{
public sealed partial class ScheduledBadge : Page
{
public ScheduledBadge()
{
this.InitializeComponent();
}
// 启动一个“轮询服务端，而后更新 Badge”的任务
private void btnStartPeriodicUpdate_Click_1(object sender, RoutedEventArgs e)
{
// 启动一个循环更新 Badge 的任务，并指定 Badge 内容的数据源和轮询周期
BadgeUpdater badgeUpdater = BadgeUpdateManager.CreateBadgeUpdaterForApplication();
badgeUpdater.StartPeriodicUpdate(new Uri("http://localhost:39629/BadgeContent.xml", UriKind.Absolute), PeriodicUpdateRecurrence.HalfHour);
// Badge 内容的数据源示例参见 WebServer 项目的 BadgeContent.xml 文件
// 此处仅用于演示，实际项目中此 Badge 内容通常是变化的
        }
}
}
　　WebServer/BadgeContent.xml




　　
OK
[源码下载]