Share via

ScheduledToastNotification Konstruktoren

  • Referenz

Definition

Namespace:
Windows.UI.Notifications

Überlädt

ScheduledToastNotification(XmlDocument, DateTime)

Erstellt und initialisiert eine neue instance einer ScheduledToastNotification, die nur einmal angezeigt wird.
ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Veraltet in Windows 10. Erstellt und initialisiert auf Windows 8-Systemen eine neue instance einer ScheduledToastNotification, die nach einer bestimmten Zeit nach dem ersten Erscheinen erneut angezeigt wird. Auf Windows 10 funktioniert dies mit ScheduledToastNotification(XmlDocument, DateTime). Um das gleiche Verhalten des Snooze-Intervalls in Windows 10 zu erreichen, können Sie Schaltflächen für Ihre Popups verwenden.

ScheduledToastNotification(XmlDocument, DateTime)

Bearbeiten

Erstellt und initialisiert eine neue instance einer ScheduledToastNotification, die nur einmal angezeigt wird.

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime);
function ScheduledToastNotification(content, deliveryTime)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset)

Parameter

content
XmlDocument

Der XML-Code, der den Inhalt der Popupbenachrichtigung definiert.

deliveryTime
DateTime DateTimeOffset

Das Datum und die Uhrzeit, zu dem Windows die Popupbenachrichtigung anzeigen soll. Sie müssen AddToSchedule vor diesem Zeitpunkt aufrufen.

Beispiele

Das folgende Beispiel zeigt eine Popupbenachrichtigung, die in einer Stunde angezeigt werden soll, einschließlich der Verwendung dieses Konstruktors zum Erstellen der Benachrichtigung.

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);

Weitere Informationen

Gilt für:

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Bearbeiten

Veraltet in Windows 10. Erstellt und initialisiert auf Windows 8-Systemen eine neue instance einer ScheduledToastNotification, die nach einer bestimmten Zeit nach dem ersten Erscheinen erneut angezeigt wird. Auf Windows 10 funktioniert dies mit ScheduledToastNotification(XmlDocument, DateTime). Um das gleiche Verhalten des Snooze-Intervalls in Windows 10 zu erreichen, können Sie Schaltflächen für Ihre Popups verwenden.

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime, TimeSpan snoozeInterval, unsigned int maximumSnoozeCount);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime, TimeSpan const& snoozeInterval, uint32_t const& maximumSnoozeCount);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime, System.TimeSpan snoozeInterval, uint maximumSnoozeCount);
function ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset, snoozeInterval As TimeSpan, maximumSnoozeCount As UInteger)

Parameter

content
XmlDocument

Der XML-Code, der den Inhalt der Popupbenachrichtigung definiert.

deliveryTime
DateTime DateTimeOffset

Das Datum und die Uhrzeit, zu der Windows zuerst die Popupbenachrichtigung anzeigen soll. Sie müssen AddToSchedule vor diesem Zeitpunkt aufrufen.

snoozeInterval
TimeSpan TimeSpan

Die Zeitspanne zwischen den Vorkommen der Benachrichtigung. Um gültig zu sein, darf dieser Wert mindestens 60 Sekunden und nicht mehr als 60 Minuten betragen.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

Die maximale Anzahl von Anzeigen dieser Benachrichtigung. Gültige Werte liegen zwischen 1 und 5.

Beispiele

Das folgende Beispiel zeigt eine Popupbenachrichtigung, die in einer Stunde angezeigt werden soll, einschließlich der Verwendung dieses Konstruktors zum Erstellen der Benachrichtigung, wobei ein Snooze-Intervall von 60 Sekunden und maximal fünf Mal zum Anzeigen der Benachrichtigung angegeben wird.

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, 60 * 1000, 5);
toast.id = "Toast" + idNumber;

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

Hinweise

Diese Art der geplanten Popupbenachrichtigung für das Snooze-Intervall eignet sich gut für eine Snooze-Alarm-ähnliche Funktionalität. Bei instance kann die Benachrichtigung alle fünf Minuten angezeigt werden, bis die maximale Anzahl von Snooze erreicht ist, es sei denn, die Benachrichtigung wird von Ihrer App explizit aus dem Zeitplan entfernt.

Wichtig

Ihre App ist dafür verantwortlich, die Benachrichtigung aus dem Zeitplan zu entfernen, sobald der Benutzer die Benachrichtigung durch eine Berührung oder einen Klick aktiviert. Andernfalls kann die Benachrichtigung erneut angezeigt werden, bis die maximale Anzahl von Snooze erreicht ist, auch wenn der Benutzer bereits damit befasst ist.

Wenn Sie lange Snooze-Intervalle wie Monate oder Jahre planen möchten, empfehlen wir, anstelle dieser Methode einzelne geplante Popups zu verwenden. Dadurch werden Zeitfehler vermieden, die durch Sommerzeit oder Schaltjahre verursacht werden.

Der folgende Code zeigt einen Aufruf dieser Methode, die maximal dreimal alle fünf Minuten ein Popup anzeigt, das bei myData beginnt.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

Weitere Informationen

Gilt für: