ScheduledToastNotification Klasse

Definition

Namespace:

Windows.UI.Notifications

Enthält den XML-Code, der die Popupbenachrichtigung definiert, die zum geplanten Zeitpunkt angezeigt wird.

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

Vererbung

Object Platform::Object IInspectable ScheduledToastNotification

Attribute

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das folgende Beispiel zeigt eine Popupbenachrichtigung, die in einer Stunde angezeigt werden soll.

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

Hinweise

Erstellen und initialisieren Sie eine neue instance dieses Objekts, indem Sie ScheduledToastNotification aufrufen.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	NotificationMirroring
1607	14393	RemoteId
1803	17134	ExpirationTime

Konstruktoren

ScheduledToastNotification(XmlDocument, DateTime)

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

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

In Windows 10 veraltet. Erstellt und initialisiert auf Windows 8 Systemen eine neue instance einer ScheduledToastNotification, die nach einer angegebenen Zeit nach dem anfänglichen Erscheinen wieder angezeigt wird. Auf Windows 10 funktioniert dies ähnlich wie ScheduledToastNotification(XmlDocument, DateTime). Um das gleiche Verhalten des Snoozeintervalls in Windows 10 zu erzielen, können Sie Schaltflächen für Ihre Popups verwenden.

Eigenschaften

Content	Ruft den XML-Code ab, der diese geplante Popupbenachrichtigung definiert.
DeliveryTime	Ruft die Uhrzeit ab, zu der diese Popupbenachrichtigung angezeigt werden soll.
ExpirationTime	Ruft die Ablaufzeit der Benachrichtigung ab oder legt diese fest.
Group	Ruft den Gruppenbezeichner für die Benachrichtigung ab oder legt diese fest.
Id	Ruft einen vom Entwickler angegebenen Wert ab, der zum Identifizieren eines bestimmten geplanten Popups verwendet wird.
MaximumSnoozeCount	Ruft die maximale Anzahl von Anzeigen dieser Benachrichtigung ab.
NotificationMirroring	Ruft einen Wert ab, der angibt, ob die Benachrichtigungsspiegelung aktiviert ist, oder legt diesen fest. (Durch die Benachrichtigungsspiegelung kann eine Benachrichtigung auf mehreren Geräten angezeigt werden.)
RemoteId	Ruft eine Remote-ID für die Benachrichtigung ab, die es dem System ermöglicht, diese Benachrichtigung mit einer anderen Benachrichtigung zu korrelieren, die auf einem anderen Gerät generiert wurde, oder legt diese fest.
SnoozeInterval	Ruft die Zeitspanne zwischen den Vorkommen der Benachrichtigung ab.
SuppressPopup	Ruft ab oder legt fest, ob die Popup-Benutzeroberfläche eines Popups auf dem Bildschirm des Benutzers angezeigt wird.
Tag	Ruft eine Zeichenfolge ab, die eine Popupbenachrichtigung innerhalb einer Gruppe eindeutig identifiziert, oder legt diese fest.

Weitere Informationen

• Beispiel für geplante Benachrichtigungen
• Popupbenachrichtigungsschema
• Richtlinien und Prüfliste für geplante Benachrichtigungen