Partager via

ScheduledToastNotification Constructeurs

  • Référence

Définition

Espace de noms:
Windows.UI.Notifications

Surcharges

ScheduledToastNotification(XmlDocument, DateTime)

Crée et initialise une nouvelle instance d’une scheduledToastNotification qui ne sera affichée qu’une seule fois.
ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Déconseillé dans Windows 10. Sur les systèmes Windows 8, crée et initialise une nouvelle instance d’un ScheduledToastNotification qui réapparaît après une heure spécifiée après l’apparition initiale. Sur Windows 10, cela fonctionne de manière équivalente à ScheduledToastNotification(XmlDocument, DateTime). Pour obtenir le même comportement d’intervalle de veille dans Windows 10, vous pouvez utiliser des boutons sur vos toasts.

ScheduledToastNotification(XmlDocument, DateTime)

Modifier

Crée et initialise une nouvelle instance d’une scheduledToastNotification qui ne sera affichée qu’une seule fois.

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)

Paramètres

content
XmlDocument

XML qui définit le contenu de la notification toast.

deliveryTime
DateTime DateTimeOffset

Date et heure auxquelles Windows doit afficher la notification toast. Vous devez appeler AddToSchedule avant cette heure.

Exemples

L’exemple suivant montre une notification toast planifiée pour s’afficher dans une heure, y compris l’utilisation de ce constructeur pour créer la notification.

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

Voir aussi

S’applique à

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Modifier

Déconseillé dans Windows 10. Sur les systèmes Windows 8, crée et initialise une nouvelle instance d’un ScheduledToastNotification qui réapparaît après une heure spécifiée après l’apparition initiale. Sur Windows 10, cela fonctionne de manière équivalente à ScheduledToastNotification(XmlDocument, DateTime). Pour obtenir le même comportement d’intervalle de veille dans Windows 10, vous pouvez utiliser des boutons sur vos toasts.

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)

Paramètres

content
XmlDocument

XML qui définit le contenu de la notification toast.

deliveryTime
DateTime DateTimeOffset

Date et heure auxquelles Windows doit d’abord afficher la notification toast. Vous devez appeler AddToSchedule avant cette heure.

snoozeInterval
TimeSpan TimeSpan

Durée entre les occurrences de la notification. Pour être valide, cette valeur ne doit pas être inférieure à 60 secondes et pas plus de 60 minutes.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

Nombre maximal de fois où afficher cette notification. Les valeurs valides sont comprises entre 1 et 5.

Exemples

L’exemple suivant montre une notification toast planifiée pour s’afficher en une heure, y compris l’utilisation de ce constructeur pour créer la notification, en spécifiant un intervalle de 60 secondes et un maximum de cinq fois pour afficher la notification.

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

Remarques

Ce type de notification de toast planifiée d’intervalle de veille est adapté à une fonctionnalité semblable à une alarme. Pour instance, la notification peut s’afficher toutes les cinq minutes jusqu’à ce que le nombre maximal de noozes soit atteint, sauf si la notification est explicitement supprimée de la planification par votre application.

Important

Votre application est responsable de la suppression de la notification de la planification une fois que l’utilisateur a activé la notification en appuyant ou en cliquant. Si vous ne le faites pas, la notification peut réapparaître jusqu’à ce que le nombre maximal de noozes soit atteint, même si l’utilisateur l’a déjà traité.

Si vous souhaitez planifier de longs intervalles de snooze comme des mois ou des années, nous vous recommandons d’utiliser des toasts planifiés individuels plutôt que cette méthode. Cela évitera les erreurs de minutage causées par l’heure d’été ou les années bissextiles.

Le code suivant montre un appel à cette méthode qui affiche un toast commençant à myData toutes les cinq minutes pour un maximum de trois fois.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

Voir aussi

S’applique à