[深刻淺出WP8.1(Runtime)]Toast通知

9.1 Toast通知

    Toast通知是在屏幕最頂上彈出來的臨時通知，是Windows Phone通用的彈出式短暫的通知，默認的系統消息都是採用Toast通知的形式，好比當你手機收到短信的時候，在手機的頂端彈出的消息就是Toast通知，點擊該通知你能夠直接進入短信的詳情頁面，通知顯示的時間是7秒鐘，7秒鐘後會自動消失，若是你想快速關閉通知，能夠採用在Toast通知上面向右滑動的手勢即可以快速地關閉掉當前的Toast通知。除了系統使用這樣的Toast通知以外，第三方的應用程序也是可使用這種通知的形式，Toast通知不單單能夠在打開應用程序的時候彈出，也能夠在應用程序關閉的狀況進行定時通知或者推送通知來進行發送，這也是Toast通知的最大的魅力所在。Toast通知只應該用於用戶特別感興趣的信息，一般涉及某種形式的用戶選擇。所以，收到IM聊天請求和用戶選擇接收的信息都是不錯的選擇。可是，當你考慮使用Toast通知時，你必須認識到很是重要的一點，因爲它的短暫性或因爲用戶設置，用戶可能錯過而未看到它。Toast通知專爲與鎖屏提醒、磁貼通知及應用中UI結合使用而設計，旨在讓用戶即時瞭解你應用中的相關事件或項目。Toast通知的實現還會分爲兩種形式，一種是在應用程序本地實現，另一種是在雲端實現，進行推送，那麼咱們這一小節主要是講解在應用程序本地實現的Toast通知，在雲端實現的Toast通知，能夠參考第12章推送通知的內容講解。

9.1.1 建立一個通知消息

    你的應用要想經過Toast通知通訊，必須在應用的清單文件Package.appxmanifest中聲明它支持 Toast，否調用Toast通知相關的API將不會生效。在Package.appxmanifest的可視化界面中，找到「Application」->「Notifications」->「Toast capable」，而後設置爲「Yes」。打開Package.appxmanifest的代碼視圖文件，能夠看到m3:VisualElements元素的ToastCapable屬性設置爲true，代碼以下所示：

    <Application Id="App" Executable="$targetnametoken$.exe" EntryPoint="ToastDemo.App">

      <m3:VisualElements …… ToastCapable="true">

        ……

      </m3:VisualElements>

    </Application>

    添加了Toast通知的權限以後，咱們來看一段建立Toast通知並彈出的代碼示例：

    // 獲取Tosat通知的模板

    XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText01);

    // 找到模板中「'text'」元素，而後添加通知的內容

    XmlNodeList elements = toastXml.GetElementsByTagName("text");

    elements[0].AppendChild(toastXml.CreateTextNode("A sample toast"));

    // 經過通知的模板建立一個Toast通知

    ToastNotification toast = new ToastNotification(toastXml);

    // 彈出通知

    ToastNotificationManager.CreateToastNotifier().Show(toast);

    下面咱們再根據上面的代碼來一步步地都講解Toast通知的編程步驟：

    （1）Toast通知的模板

    每一個Toast通知的格式都會對應着一個XML的模板，在咱們建立一個Toast通知對象以前，咱們首先須要選擇Toast通知的模板。Toast通知的模板由ToastTemplateType來進行描述，能夠經過Toast通知管理類ToastNotificationManager類的靜態方法GetTemplateContent來獲取對應的Toast通知模板。在Windows Phone的應用程序裏面主要會用到ToastImageAndText01和ToastImageAndText02這兩種類型的模板。

    1）ToastText01模板表示是一個最簡單的Toast通知模板，只有通知的內容信息，它的XML格式以下所示：

    <toast>

        <visual>

            <binding template="ToastText01">

                <text id="1">bodyText</text>

            </binding> 

        </visual>

    </toast>

    2）ToastText02模板表示是包含消息頭和消息體的模板，消息頭是一個加粗文本字符串，消息頭和消息體會使用空格隔開，它的XML格式以下所示：

    <toast>

        <visual>

            <binding template="ToastText02">

                <text id="1">headlineText</text>

                <text id="2">bodyText</text>

            </binding> 

        </visual>

    </toast>

    （2）添加Toast通知的內容

    獲取了Toast通知的模板對象以後，咱們能夠經過XML對象XmlDocument對象的相關屬性和方法來修改XML的內容，從而實如今Toast通知的XML模板上添加消息的內容信息。

    （3）建立Toast通知的對象

    添加好Toast通知的內容以後，咱們就可使用XmlDocument對象來初始化一個Toast通知對象，這時候可使用ToastNotification類的構造方法ToastNotification(XmlDocument content)方法來進行初始化，這也是Toast通知惟一的構造方法。

    （4）彈出Toast通知

    彈出Toast通知可使用ToastNotifier類的Show方法，ToastNotifier類是表示Toast通知的通知操做管理器，使用該類能夠實現獲取Toast列表，打開Toast通知，取下Toast通知等操做。

9.1.2 按期 Toast 通知

    Toast通知不單單能夠在應用程序運行的時候彈出，還能夠在應用程序離開前臺的時候彈出，這時候可使用按期Toast來實現。按期Toast通知就是經過預設將來的一個時間，在這個時間點上彈出Toast通知，若是應用程序這時候不在前臺運行，Toast通知也能夠運行，用戶點擊Toast通知的時候能夠直接進入當前的應用程序。

    ScheduledToastNotification類表示是按期Toast通知的信息類，你可使用構造方法ScheduledToastNotification(XmlDocument content, DateTimeOffset deliveryTime)方法來建立一個ScheduledToastNotification對象，而後添加到Toast通知的定時計劃裏面，其中content參數表示是消息的XML內容，deliveryTime表示是消息彈出的時間。示例代碼以下所示：

    // 建立一個ToastText02的消息模板

    XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText02);

    // 獲取XML模板的text元素

    XmlNodeList toastNodeList = toastXml.GetElementsByTagName("text");

    // 設置通知頭信息

    toastNodeList.Item(0).AppendChild(toastXml.CreateTextNode("Toast title"));

    // 設置通知體信息

    toastNodeList.Item(1).AppendChild(toastXml.CreateTextNode("Toast content"));

    // 獲取一個距離如今還有10秒鐘的時間點

    DateTime startTime = DateTime.Now.AddSeconds(10);

    // 使用XML模板和通知的時間建立一個ScheduledToastNotification對象

    ScheduledToastNotification recurringToast = new ScheduledToastNotification(toastXml, startTime);

    // 設置通知的ID

    recurringToast.Id = "ScheduledToast1";

    // 把定時Toast通知添加到通知計劃裏面

    ToastNotificationManager.CreateToastNotifier().AddToSchedule(recurringToast);

9.1.3 實例演示：Toast通知

下面給Toast通知的示例：實現ToastText01和ToastText02兩種模板以及定時通知。

    代碼清單9-1：Toast通知（第9章\Examples_9_1）

MainPage.xaml文件主要代碼
------------------------------------------------------------------------------------------------------------------
    <StackPanel>
        <Button Content="ToastText01模板通知" x:Name="toastText01" Click="toastText01_Click" Width="370"></Button>
        <Button Content="ToastText02模板通知" x:Name="toastText02" Click="toastText02_Click" Width="370"></Button>
        <Button Content="XML模板通知" x:Name="toastXML" Click="toastXML_Click" Width="370"></Button>
        <Button Content="定時通知" x:Name="scheduledToast" Click="scheduledToast_Click" Width="370"></Button>
        <TextBlock x:Name="info"></TextBlock>
    </StackPanel>

MainPage.xaml.cs文件主要代碼
------------------------------------------------------------------------------------------------------------------
    // 彈出ToastText01模板的Toast通知
    private void toastText01_Click(object sender, RoutedEventArgs e)
    {
        XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText01);
        XmlNodeList elements = toastXml.GetElementsByTagName("text");
        elements[0].AppendChild(toastXml.CreateTextNode("Hello Windows Phone 8.1"));
        ToastNotification toast = new ToastNotification(toastXml);
        toast.Activated += toast_Activated;
        toast.Dismissed += toast_Dismissed;
        toast.Failed += toast_Failed;
        ToastNotificationManager.CreateToastNotifier().Show(toast);
    }
    // 彈出ToastText02模板的Toast通知
    private void toastText02_Click(object sender, RoutedEventArgs e)
    {
        XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText02);
        XmlNodeList elements = toastXml.GetElementsByTagName("text");
        elements[0].AppendChild(toastXml.CreateTextNode("WP8.1"));
        elements[1].AppendChild(toastXml.CreateTextNode("Hello Windows Phone 8.1"));
        ToastNotification toast = new ToastNotification(toastXml);
        toast.Activated += toast_Activated;
        toast.Dismissed += toast_Dismissed;
        toast.Failed += toast_Failed;
        ToastNotificationManager.CreateToastNotifier().Show(toast);
    }
   // 直接使用XML字符串來拼接出ToastText02模板的Toast通知
    private void toastXML_Click(object sender, RoutedEventArgs e)
    {
        string toastXmlString = "<toast>"
        + "<visual>"
        + "<binding template='ToastText02'>"
        + "<text id='1'>WP8.1</text>"
        + "<text id='2'>" + "Received: " + DateTime.Now.ToLocalTime() + "</text>"
        + "</binding>"
        + "</visual>"
        + "</toast>";
        XmlDocument toastXml = new XmlDocument();
        toastXml.LoadXml(toastXmlString);
        ToastNotification toast = new ToastNotification(toastXml);
        toast.Activated += toast_Activated;
        toast.Dismissed += toast_Dismissed;
        toast.Failed += toast_Failed;
        ToastNotificationManager.CreateToastNotifier().Show(toast);
    }
    // Toast通知彈出失敗的事件
    async void toast_Failed(ToastNotification sender, ToastFailedEventArgs args)
    {
        await this.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
                info.Text = "Toast通知失敗：" + args.ErrorCode.Message;
            });       
    }
    // Toast通知消失的事件，當通知自動消失或者手動取消會觸發該事件
    async void toast_Dismissed(ToastNotification sender, ToastDismissedEventArgs args)
    {
        await this.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
            {
                info.Text = "Toast通知消失：" + args.Reason.ToString();
            });          
    }
    // Toast通知激活的事件，當通知彈出時，點擊通知會觸發該事件
    async void toast_Activated(ToastNotification sender, object args)
    {
        await this.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
        {
            info.Text = "Toast通知激活";
        });
    }
    // 定時Toast通知
    private void scheduledToast_Click(object sender, RoutedEventArgs e)
    {
        XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText02);
        XmlNodeList toastNodeList = toastXml.GetElementsByTagName("text");
        toastNodeList.Item(0).AppendChild(toastXml.CreateTextNode("Toast title"));
        toastNodeList.Item(1).AppendChild(toastXml.CreateTextNode("Toast content"));
        DateTime startTime = DateTime.Now.AddSeconds(3);
        ScheduledToastNotification recurringToast = new ScheduledToastNotification(toastXml, startTime);
        recurringToast.Id = "ScheduledToast1";
        ToastNotificationManager.CreateToastNotifier().AddToSchedule(recurringToast);
    }

本文來源於《深刻淺出Windows Phone 8.1 應用開發》

WP8.1 Runtime文章列表：http://www.cnblogs.com/linzheng/p/3998037.html

源代碼下載：http://vdisk.weibo.com/s/zt_pyrfNHb99O

歡迎關注個人微博@WP林政   微信公衆號：wp開發（號：wpkaifa）

WP8.1技術交流羣：372552293