Condividi tramite

ScheduledToastNotification Costruttori

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Notifications

Overload

ScheduledToastNotification(XmlDocument, DateTime)

Crea e inizializza una nuova istanza di un oggetto ScheduledToastNotification che verrà visualizzato una sola volta.
ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Deprecato in Windows 10. Nei sistemi Windows 8 crea e inizializza una nuova istanza di un oggetto ScheduledToastNotification visualizzato nuovamente dopo un'ora specificata dopo la visualizzazione iniziale. In Windows 10, questa funzione equivale a ScheduledToastNotification(XmlDocument, DateTime). Per ottenere lo stesso comportamento di intervallo di snooze in Windows 10, è possibile usare i pulsanti nei popup.

ScheduledToastNotification(XmlDocument, DateTime)

Modifica

Crea e inizializza una nuova istanza di un oggetto ScheduledToastNotification che verrà visualizzato una sola volta.

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)

Parametri

content
XmlDocument

XML che definisce il contenuto della notifica popup.

deliveryTime
DateTime DateTimeOffset

Data e ora in cui Windows deve visualizzare la notifica di tipo avviso popup. Prima di questa volta, è necessario chiamare AddToSchedule .

Esempio

Nell'esempio seguente viene illustrata una notifica di tipo avviso popup pianificata per la visualizzazione in un'ora, incluso l'uso di questo costruttore per creare la notifica.

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

Vedi anche

Si applica a

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Modifica

Deprecato in Windows 10. Nei sistemi Windows 8 crea e inizializza una nuova istanza di un oggetto ScheduledToastNotification visualizzato nuovamente dopo un'ora specificata dopo la visualizzazione iniziale. In Windows 10, questa funzione equivale a ScheduledToastNotification(XmlDocument, DateTime). Per ottenere lo stesso comportamento di intervallo di snooze in Windows 10, è possibile usare i pulsanti nei popup.

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)

Parametri

content
XmlDocument

XML che definisce il contenuto della notifica popup.

deliveryTime
DateTime DateTimeOffset

Data e ora in cui Windows deve prima visualizzare la notifica di tipo avviso popup. Prima di questa volta, è necessario chiamare AddToSchedule .

snoozeInterval
TimeSpan TimeSpan

Quantità di tempo tra occorrenze della notifica. Per essere valido, questo valore deve essere inferiore a 60 secondi e non più di 60 minuti.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

Numero massimo di volte per visualizzare questa notifica. I valori validi sono compresi tra 1 e 5.

Esempio

L'esempio seguente mostra una notifica di tipo avviso popup pianificata per la visualizzazione in un'ora, incluso l'uso di questo costruttore per creare la notifica, specificando un intervallo di snooze di 60 secondi e un massimo di cinque volte per visualizzare la notifica.

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

Commenti

Questo tipo di notifica di tipo avviso popup pianificato per l'intervallo di snooze è adatto per una funzionalità simile all'allarme. Ad esempio, la notifica può essere visualizzata ogni cinque minuti fino al raggiungimento del numero massimo di snooze, a meno che la notifica non venga rimossa in modo esplicito dalla pianificazione dall'app.

Importante

L'app è responsabile della rimozione della notifica dalla pianificazione dopo che l'utente attiva la notifica tramite tocco o clic. In caso contrario, la notifica non viene visualizzata nuovamente fino a quando non viene raggiunto il numero massimo di snooze, anche se l'utente lo ha già gestito.

Se si desidera pianificare intervalli di snooze lunghi come mesi o anni, è consigliabile usare singoli avvisi popup pianificati anziché questo metodo. Ciò consente di evitare errori di intervallo causati dall'ora legale o dagli anni salti.

Il codice seguente mostra una chiamata a questo metodo che visualizza un avviso popup a partire da myData ogni cinque minuti per un massimo di tre volte.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

Vedi anche

Si applica a