Freigeben über


ScheduledToastNotification Klasse

Definition

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

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
Vererbung
Object Platform::Object IInspectable ScheduledToastNotification
Attribute

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.

Gilt für:

Weitere Informationen