ScheduledToastNotification 類別

定義

包含 XML,定義將在排程時間顯示的快顯通知。

public ref class ScheduledToastNotification sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IScheduledToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ScheduledToastNotification 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.IScheduledToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class ScheduledToastNotification 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.IScheduledToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ScheduledToastNotification final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IScheduledToastNotificationFactory), 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 ScheduledToastNotification
[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.IScheduledToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ScheduledToastNotification
[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.IScheduledToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ScheduledToastNotification
function ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)
Public NotInheritable Class ScheduledToastNotification
繼承
Object Platform::Object IInspectable ScheduledToastNotification
屬性

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 引進)

範例

下列範例顯示排定在一小時內顯示的快顯通知。

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = Math.floor(Math.random() * 100000000);  // Generates a unique ID number for the notification.

// Set up the notification text.
var toastXml = Notifications.ToastNotificationManager.getTemplateContent(Notifications.ToastTemplateType.toastText02);
var strings = toastXml.getElementsByTagName("text");
strings[0].appendChild(toastXml.createTextNode(This is a scheduled toast notification));
strings[1].appendChild(toastXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Create the toast notification object.
var toast = new Notifications.ScheduledToastNotification(toastXml, dueTime);
toast.id = "Toast" + idNumber;

// Add to the schedule.
Notifications.ToastNotificationManager.createToastNotifier().addToSchedule(toast);

備註

呼叫 ScheduledToastNotification來建立和初始化這個物件的新實例。

版本歷程記錄

Windows 版本 SDK 版本 新增值
1607 14393 NotificationMirroring
1607 14393 RemoteId
1803 17134 ExpirationTime

建構函式

ScheduledToastNotification(XmlDocument, DateTime)

建立並初始化 ScheduledToastNotification 的新實例,該實例只會顯示一次。

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Windows 10中已被取代。 在Windows 8系統上,建立並初始化ScheduledToastNotification的新實例,該實例會在一開始出現之後的指定時間後重新出現。 在Windows 10上,此函式相當於ScheduledToastNotification (XmlDocument、DateTime) 。 若要在Windows 10中達到相同的延遲間隔行為,您可以在快顯通知上使用按鈕

屬性

Content

取得定義這個排程快顯通知的 XML。

DeliveryTime

取得排定顯示此快顯通知的時間。

ExpirationTime

取得或設定通知的到期時間。

Group

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

Id

取得開發人員指定的值,用來識別特定的排程快顯通知。

MaximumSnoozeCount

取得顯示此通知的最大次數。

NotificationMirroring

取得或設定值,指定是否啟用通知鏡像。 (通知鏡像可讓通知出現在多個裝置上。)

RemoteId

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

SnoozeInterval

取得通知出現之間的時間量。

SuppressPopup

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

Tag

取得或設定可唯一識別 群組內快顯通知的字串。

適用於

另請參閱