重新想象 Windows 8 Store Apps (34)

[源码下载]

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

作者：webabcd


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

• Toast - 通知
• Tile - 瓷贴
• Badge - 徽章

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

<Page    x:Class="XamlDemo.Notification.Toast.Demo"    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">    <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="btnShortToast" Content="Short Toast" Click="btnShortToast_Click_1" Margin="0 10 0 0" />        <!--弹出通知（通知显示的时间较长）-->        <Button Name="btnLongToast" Content="Long Toast" Click="btnLongToast_Click_1" Margin="0 10 0 0" />        <TextBlock Name="lblStatus" FontSize="14.667" Margin="0 10 0 0" />    </StackPanel></Page>

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; // 短时通知，默认值            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 = "<toast duration='long'>"                               + "<visual version='1'>"                               + "<binding template='ToastText01'>"                               + "<text id='1'>我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。我是通知正文，可换行，最多三行。</text>"                               + "</binding>"                               + "</visual>"                               + "<audio silent='true'/>"                               + "</toast>";            // 将字符串转换为 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

<Page    x:Class="XamlDemo.Notification.Tile.Demo"    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"    xmlns:local="using:XamlDemo.Notification.Tile"    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="btnXmlTile" Content="通过手工方式构造 xml 模板，以更新 Tile" Click="btnXmlTile_Click_1" Margin="0 10 0 0" />                        <Button Name="btnTemplateTile" Content="通过模板帮助类更新 Tile" Click="btnTemplateTile_Click_1" Margin="0 10 0 0" />            <Button Name="btnClearTile" Content="清除 Tile" Click="btnClearTile_Click_1" Margin="0 10 0 0" />            <TextBlock Name="lblStatus" FontSize="14.667" Margin="0 10 0 0" />        </StackPanel>    </Grid></Page>

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 = "<tile>"                                 + "<visual>"                                 + "<binding template='TileWideText03'>"                                 + "<text id='1'>hi webabcd</text>"                                 + "</binding>"                                 + "<binding template='TileSquareText04'>"                                 + "<text id='1'>hi webabcd</text>"                                 + "</binding>"                                 + "</visual>"                                 + "</tile>";            // 将字符串转换为 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.cnblogs.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.cnblogs.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

<Page    x:Class="XamlDemo.Notification.Badge.Demo"    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"    xmlns:local="using:XamlDemo.Notification.Badge"    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="btnUpdateBadgeWidthNumber" Content="以数字的方式更新 Badge" Click="btnUpdateBadgeWidthNumber_Click_1" Margin="0 10 0 0" />            <Button Name="btnUpdateBadgeWidthIcon" Content="以图标的方式更新 Badge" Click="btnUpdateBadgeWidthIcon_Click_1" Margin="0 10 0 0" />                    </StackPanel>    </Grid></Page>

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();        }    }}

OK
[源码下载]