ToastNotification Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

Define el contenido, los metadatos y eventos asociados y la hora de expiración de una notificación del sistema.

public ref class ToastNotification 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.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification 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.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification

function ToastNotification(content)

Public NotInheritable Class ToastNotification

Herencia

Object Platform::Object IInspectable ToastNotification

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)

Comentarios

Para obtener instrucciones de procedimientos para implementar notificaciones del sistema en la aplicación, consulte Envío de una notificación del sistema local desde aplicaciones de C#.

Guía para controlar la activación de aplicaciones para las notificaciones del sistema:

• Las aplicaciones para UWP deben usar OnActivated para controlar las activaciones del sistema.
• A partir de la compilación 19041 de WinRT, las aplicaciones empaquetadas (incluidas las aplicaciones empaquetadas con ubicación externa) pueden usar ToastNotificationActionTrigger para controlar las activaciones para obtener más detalles.
• Las aplicaciones de escritorio pueden usar la activación COM siguiendo escritorio : enviar notificación del sistema local.
• Si ninguna de las opciones de activación se ajusta a la aplicación, siga el ejemplo de este documento para usar correctamente controladores de eventos.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	data
1703	15063	Priority
1903	18362	ExpiresOnReboot

Constructores

ToastNotification(XmlDocument)

Crea e inicializa una nueva instancia de ToastNotification.

Propiedades

Content	Obtiene el XML que define la notificación del sistema actual.
Data	Obtiene o establece información adicional sobre el estado de la notificación del sistema.
ExpirationTime	Obtiene o establece la hora después de la cual no se debe mostrar una notificación del sistema.
ExpiresOnReboot	Indica si la notificación del sistema permanecerá en el Centro de notificaciones después de un reinicio.
Group	Obtiene o establece el identificador de grupo de la notificación.
NotificationMirroring	Obtiene o establece un valor que especifica si se permite la creación de reflejo de notificaciones.
Priority	Obtiene o establece la prioridad de la notificación del sistema.
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.
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 el identificador único de esta notificación dentro del grupo de notificaciones.

Eventos

Activated	Se produce cuando el usuario activa una notificación del sistema a través de un clic o entrada táctil. Las aplicaciones que se ejecutan se suscriben a este evento.
Dismissed	Se produce cuando una notificación del sistema deja la pantalla, ya sea expirando o descartando explícitamente por el usuario. Las aplicaciones que se ejecutan se suscriben a este evento.
Failed	Se produce cuando se produce un error cuando Windows intenta generar una notificación del sistema. Las aplicaciones que se ejecutan se suscriben a este evento.

Consulte también

• Ejemplo de notificaciones del sistema
• Ejemplo sobre cómo enviar notificaciones del sistema de aplicaciones de escritorio
• Esquema XML de notificación del sistema
• Iconos, distintivos y notificaciones
• Inicio rápido: Envío de una notificación del sistema
• Inicio rápido: Envío de una notificación de inserción del sistema
• Inicio rápido: Envío de una notificación del sistema desde el escritorio
• Directrices y lista de comprobación para las notificaciones del sistema
• Cómo controlar la activación desde una notificación del sistema
• Cómo participar en las notificaciones del sistema
• Programación de una notificación del sistema
• Cómo habilitar las notificaciones del sistema del escritorio a través de AppUserModelID
• Catálogo de plantillas del sistema
• Opciones de audio del sistema