共用方式為

快速入門：從桌面傳送快顯通知

本快速入門指南說明如何從桌面應用程式引發快顯通知。

先決條件

  • 圖書館
    • C++：Runtime.object.lib
    • C#：Windows.Winmd
  • 必須將一個具有 System.AppUserModel.ID的捷徑安裝至「開始」畫面。 不過請注意，這項功能不必釘選到 [開始] 畫面。 如需詳細資訊，請參閱 如何透過AppUserModelID啟用桌面快顯通知。
  • Microsoft Visual Studio 的一個版本，至少支援 Windows 8

說明

1.建立快顯通知內容

注意

當您指定包含影像的快顯通知範本時，請注意桌面應用程式只能使用本機影像，不支援網頁影像。 此外，本機圖像檔的路徑必須提供為絕對路徑（而非相對路徑）。

 

// Get a toast XML template
XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastImageAndText04);

// Fill in the text elements
XmlNodeList stringElements = toastXml.GetElementsByTagName("text");
for (int i = 0; i < stringElements.Length; i++)
{
    stringElements[i].AppendChild(toastXml.CreateTextNode("Line " + i));
}

// Specify the absolute path to an image
String imagePath = "file:///" + Path.GetFullPath("toastImageAndText.png");
XmlNodeList imageElements = toastXml.GetElementsByTagName("image");

ToastNotification toast = new ToastNotification(toastXml);

2.建立並附加事件處理程式

註冊快顯通知事件的處理程式：Activated、Dismissed 和 Failed。 傳統型應用程式至少必須訂閱 Activated 事件，以便在使用者選取應用程式時，從快顯通知處理應用程式的預期啟用。

toast.Activated += ToastActivated;
toast.Dismissed += ToastDismissed;
toast.Failed += ToastFailed;

3. 傳送提示通知

重要

每次您呼叫 CreateToastNotifier時，都必須在 [開始] 頁面上包含應用程式捷徑的 AppUserModelID。 如果您沒有這麼做，則不會顯示您的訊息通知。

 

ToastNotificationManager.CreateToastNotifier(appID).Show(toast);

4.處理回呼

如果應用程式收到 Toast 通知的「已啟動」回呼，請將應用程式的視窗移至最前面。 當使用者選取通知提示時，預期應用程式會開啟至與該通知提示內容相關的檢視。

從桌面應用程式傳送快顯通知範例

如何透過 AppUserModelID 啟用桌面快顯通知

Toast XML 架構

快顯通知概觀

快速開始：傳送快顯通知

快速入門：傳送 Toast 推播通知

快顯通知的指導方針和檢查清單

如何選擇和使用提示訊息範本

如何處理快顯通知的啟用

如何選擇接收快顯通知

選擇吐司範本

快顯通知音訊選項

 

 

  • Last updated on