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

2022-10-18 17:41:43

介绍
重新想象 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(), TimeSpan.FromSeconds(), );

            string toastId = new Random().Next(, ).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 = ; i < toastCount; i++)

            {

                ScheduledToastNotification toast = scheduledToasts[i];

                dataSource.Add(new MyScheduledToast()

                {

                    ToastId = toast.Id,

                    Text = toast.Content.GetElementsByTagName("text")[].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 = ; 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
[源码下载]

码农公寓

相关文章