ToastNotification 類別

  • 參考

定義

命名空間:
Windows.UI.Notifications
編輯

定義快顯通知的內容、相關聯的中繼資料和事件，以及到期時間。

public ref class ToastNotification sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotification final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class ToastNotification final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ToastNotification
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ToastNotification
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification
function ToastNotification(content)
Public NotInheritable Class ToastNotification
繼承
Object Platform::Object IInspectable ToastNotification
屬性
ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

如需在應用程式中實作快顯通知的作法指引，請參閱 從 C# 應用程式傳送本機快顯通知。

處理快顯通知的應用程式啟用指引：

  • UWP 應用程式應該使用 OnActivated 來處理快顯通知啟用。
  • 從 WinRT 組建 19041 開始，已封裝的應用程式 (包括具有外部位置的已封裝應用程式，) 能夠使用 ToastNotificationActionTrigger 來處理啟用 以取得詳細資料。
  • 傳統型應用程式可以使用 COM 啟用，方法是遵循 桌面 - 傳送本機快顯通知。
  • 如果沒有任何啟用選項符合您的應用程式，請遵循本檔中的範例，以正確使用事件處理常式。

版本歷程記錄

Windows 版本 SDK 版本 已新增值
1607 14393 NotificationMirroring
1607 14393 RemoteId
1703 15063 資料
1703 15063 優先順序
1903 18362 ExpiresOnReboot

建構函式

ToastNotification(XmlDocument)

建立並初始化 ToastNotification的新實例。

屬性

Content

取得定義目前快顯通知的 XML。
Data

取得或設定有關快顯通知狀態的其他資訊。
ExpirationTime

取得或設定不應該顯示快顯通知的時間。
ExpiresOnReboot

指出快顯通知是否會在重新開機後保留在通知中心。
Group

取得或設定通知的群組識別碼。
NotificationMirroring

取得或設定值，指定是否允許通知鏡像。
Priority

取得或設定快顯通知的優先順序。
RemoteId

取得或設定通知的遠端識別碼，讓系統能夠將此通知與另一個裝置上產生的通知相互關聯。
SuppressPopup

取得或設定快顯通知的快顯 UI 是否顯示在使用者的畫面上。
Tag

取得或設定通知 群組內此通知的唯一識別碼。

事件

Activated

當使用者透過按一下或觸控啟動快顯通知時發生。 執行的應用程式會訂閱此事件。
Dismissed

發生于快顯通知離開畫面時，使用者已過期或明確關閉。 執行的應用程式會訂閱此事件。
Failed

發生于 Windows 嘗試引發快顯通知時發生錯誤。 執行的應用程式會訂閱此事件。

適用於

另請參閱