Compartir a través de


ToastNotification Clase

Definición

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.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotification final
/// [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")]
class ToastNotification final
/// [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.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ToastNotification
[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")]
public sealed class ToastNotification
[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

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.

Se aplica a

Consulte también