ScheduledToastNotification Classe

Definizione

Spazio dei nomi:

Windows.UI.Notifications

Contiene il codice XML che definisce la notifica di tipo avviso popup che verrà visualizzata all'ora pianificata.

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

Ereditarietà

Object Platform::Object IInspectable ScheduledToastNotification

Attributi

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene illustrata una notifica di tipo avviso popup pianificata per la visualizzazione in un'ora.

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

Commenti

Creare e inizializzare una nuova istanza di questo oggetto chiamando ScheduledToastNotification.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	NotificationMirroring
1607	14393	RemoteId
1803	17134	ExpirationTime

Costruttori

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 che viene nuovamente visualizzato 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.

Proprietà

Content	Ottiene il codice XML che definisce la notifica di tipo avviso popup pianificato.
DeliveryTime	Ottiene l'ora in cui verrà visualizzata la notifica di tipo avviso popup.
ExpirationTime	Ottiene o imposta l'ora di scadenza della notifica.
Group	Ottiene o imposta l'identificatore del gruppo per la notifica.
Id	Ottiene un valore specificato dallo sviluppatore usato per identificare un avviso popup pianificato specifico.
MaximumSnoozeCount	Ottiene il numero massimo di volte per visualizzare questa notifica.
NotificationMirroring	Ottiene o imposta un valore che specifica se il mirroring delle notifiche è abilitato. Il mirroring delle notifiche consente di visualizzare una notifica in più dispositivi.
RemoteId	Ottiene o imposta un ID remoto per la notifica che consente al sistema di correlare questa notifica con un'altra generata in un altro dispositivo.
SnoozeInterval	Ottiene la quantità di tempo tra occorrenze della notifica.
SuppressPopup	Ottiene o imposta se l'interfaccia utente popup di un avviso popup viene visualizzata nella schermata dell'utente.
Tag	Ottiene o imposta una stringa che identifica in modo univoco una notifica di tipo avviso popup all'interno di un gruppo.

Vedi anche

• Esempio di notifiche pianificate
• Schema di avviso popup
• Linee guida ed elenco di controllo per le notifiche pianificate