Compartir a través de

ScheduledToastNotification Constructores

  • Referencia

Definición

Espacio de nombres:
Windows.UI.Notifications

Sobrecargas

ScheduledToastNotification(XmlDocument, DateTime)

Crea e inicializa una nueva instancia de scheduledToastNotification que solo se mostrará una vez.
ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

En desuso en Windows 10. En los sistemas Windows 8, crea e inicializa una nueva instancia de scheduledToastNotification que vuelve a aparecer después de una hora especificada después de que aparezca inicialmente. En Windows 10, esta función funciona de forma equivalente a ScheduledToastNotification(XmlDocument, DateTime). Para lograr el mismo comportamiento de intervalo de posposición en Windows 10, puedes usar botones en las notificaciones del sistema.

ScheduledToastNotification(XmlDocument, DateTime)

Editar

Crea e inicializa una nueva instancia de scheduledToastNotification que solo se mostrará una vez.

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)

Parámetros

content
XmlDocument

XML que define el contenido de la notificación del sistema.

deliveryTime
DateTime DateTimeOffset

Fecha y hora en que Windows debe mostrar la notificación del sistema. Debe llamar a AddToSchedule antes de esta hora.

Ejemplos

En el ejemplo siguiente se muestra una notificación del sistema programada para mostrarse en una hora, incluido el uso de este constructor para crear la notificación.

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

Consulte también

Se aplica a

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Editar

En desuso en Windows 10. En los sistemas Windows 8, crea e inicializa una nueva instancia de scheduledToastNotification que vuelve a aparecer después de una hora especificada después de que aparezca inicialmente. En Windows 10, esta función funciona de forma equivalente a ScheduledToastNotification(XmlDocument, DateTime). Para lograr el mismo comportamiento de intervalo de posposición en Windows 10, puedes usar botones en las notificaciones del sistema.

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)

Parámetros

content
XmlDocument

XML que define el contenido de la notificación del sistema.

deliveryTime
DateTime DateTimeOffset

Fecha y hora en que Windows debe mostrar primero la notificación del sistema. Debe llamar a AddToSchedule antes de esta hora.

snoozeInterval
TimeSpan TimeSpan

Cantidad de tiempo entre repeticiones de la notificación. Para ser válido, este valor no debe ser inferior a 60 segundos y no más de 60 minutos.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

Número máximo de veces que se va a mostrar esta notificación. Los valores válidos van de 1 a 5.

Ejemplos

En el ejemplo siguiente se muestra una notificación del sistema programada para mostrarse en una hora, incluido el uso de este constructor para crear la notificación, especificando un intervalo de posposición de 60 segundos y un máximo de cinco veces para mostrar la notificación.

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

Comentarios

Este tipo de notificación del sistema programada de intervalo de posposición es adecuado para una funcionalidad similar a alarma. Por ejemplo, la notificación se puede mostrar cada cinco minutos hasta que se alcance el número máximo de posponer, a menos que la aplicación quite explícitamente la notificación de la programación.

Importante

La aplicación es responsable de quitar la notificación de la programación una vez que el usuario activa la notificación a través de un toque o clic. Si no lo hace, puede hacer que la notificación vuelva a aparecer hasta que se alcance el número máximo de posponer, incluso si el usuario ya lo ha tratado.

Si desea programar intervalos largos de posponer como meses o años, se recomienda usar notificaciones del sistema programadas individuales en lugar de este método. Esto evitará errores de tiempo causados por el horario de verano o años bisiestos.

El código siguiente muestra una llamada a este método que muestra una notificación del sistema que comienza en myData cada cinco minutos durante un máximo de tres veces.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

Consulte también

Se aplica a