ScheduledToastNotification 類別

定義

命名空間:

Windows.UI.Notifications

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

public ref class ScheduledToastNotification sealed

/// [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.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

屬性

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

範例

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

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	取得或設定可唯一識別 群組內快顯通知的字串。

另請參閱

• 排程通知範例
• 快顯通知結構描述
• 排程通知的指導方針和檢查清單