ScheduledToastNotification Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

Contiene el XML que define la notificación del sistema que se mostrará en la hora programada.

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

Herencia

Object Platform::Object IInspectable ScheduledToastNotification

Atributos

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo siguiente se muestra una notificación del sistema programada para mostrarse en una hora.

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

Comentarios

Cree e inicialice una nueva instancia de este objeto llamando a ScheduledToastNotification.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	NotificationMirroring
1607	14393	RemoteId
1803	17134	ExpirationTime

Constructores

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 Windows 8 sistemas, 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, puede usar botones en las notificaciones del sistema.

Propiedades

Content	Obtiene el XML que define esta notificación del sistema programada.
DeliveryTime	Obtiene la hora en que se programa esta notificación del sistema.
ExpirationTime	Obtiene o establece la hora de expiración de la notificación.
Group	Obtiene o establece el identificador de grupo de la notificación.
Id	Obtiene un valor especificado por el desarrollador que se usa para identificar una notificación del sistema programada específica.
MaximumSnoozeCount	Obtiene el número máximo de veces que se va a mostrar esta notificación.
NotificationMirroring	Obtiene o establece un valor que especifica si la creación de reflejo de notificaciones está habilitada. (La creación de reflejo de notificaciones permite que aparezca una notificación en varios dispositivos).
RemoteId	Obtiene o establece un identificador remoto para la notificación que permite al sistema correlacionar esta notificación con otra generada en otro dispositivo.
SnoozeInterval	Obtiene la cantidad de tiempo entre repeticiones de la notificación.
SuppressPopup	Obtiene o establece si la interfaz de usuario emergente de una notificación del sistema se muestra en la pantalla del usuario.
Tag	Obtiene o establece una cadena que identifica de forma única una notificación del sistema dentro de un grupo.

Consulte también

• Ejemplo de notificaciones programadas
• Esquema de notificaciones del sistema
• Directrices y lista de comprobación para las notificaciones programadas