快速入門:從桌面傳送快顯通知
本快速入門說明如何從傳統型應用程式引發快顯通知。
必要條件
- 程式庫
- C++:Runtime.object.lib
- C#:Windows.Winmd
- 具有 System.AppUserModel.ID的應用程式快捷方式必須安裝到 [開始] 畫面。 不過請注意,它不需要釘選到 [開始] 畫面。 如需詳細資訊,請參閱 如何透過 AppUserModelID 啟用桌面快顯通知。
- 至少支援 Windows 8 的 Microsoft Visual Studio 版本
指示
1.建立快顯通知內容
注意
當您指定包含影像的快顯通知範本時,請注意,傳統型應用程式只能使用本機映射;不支援 Web 映射。 此外,本機影像檔的路徑必須提供為絕對 (不是相對) 路徑。
// 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 事件,以便在使用者選取應用程式時,從快顯通知處理應用程式的預期啟用。
toast.Activated += ToastActivated;
toast.Dismissed += ToastDismissed;
toast.Failed += ToastFailed;
3.傳送快顯通知
重要
每次呼叫CreateToastNotifier時,都必須在 [開始] 畫面中包含您 app 快捷方式的AppUserModelID。 如果您無法這麼做,將不會顯示您的快顯通知。
ToastNotificationManager.CreateToastNotifier(appID).Show(toast);
4.處理回呼
如果應用程式從快顯通知收到「啟動」回呼,請讓應用程式視窗移至前景。 當使用者選取快顯通知時,預期應用程式會啟動至與該快顯通知內容相關的檢視。
相關主題