ToastNotificationManager Clase

Definición

Espacio de nombres:

Windows.UI.Notifications

Crea objetos ToastNotifier que se usan para generar notificaciones del sistema. Esta clase también proporciona acceso al contenido XML de las plantillas del sistema proporcionadas por el sistema para que pueda personalizar ese contenido para usarlo en las notificaciones.

public ref class ToastNotificationManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotificationManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class ToastNotificationManager

Public Class ToastNotificationManager

Herencia

Object Platform::Object IInspectable ToastNotificationManager

Atributos

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 cómo crear y enviar una notificación del sistema que incluye texto e imágenes, incluido el uso de los métodos GetTemplateContent y CreateToastNotifier .

var notifications = Windows.UI.Notifications;

// Get the toast notification manager for the current app.
var notificationManager = notifications.ToastNotificationManager;

// The getTemplateContent method returns a Windows.Data.Xml.Dom.XmlDocument object
// that contains the toast notification XML content.
var template = notifications.toastTemplateType.toastImageAndText01;
var toastXml = notificationManager.getTemplateContent(notifications.ToastTemplateType[template]);

// You can use the methods from the XML document to specify the required elements for the toast.
var images = toastXml.getElementsByTagName("image");
images[0].setAttribute("src", "images/toastImageAndText.png");

var textNodes = toastXml.getElementsByTagName("text");
textNodes.forEach(function (value, index) {
    var textNumber = index + 1;
    var text = "";
    for (var j = 0; j < 10; j++) {
        text += "Text input " + /*@static_cast(String)*/textNumber + " ";
    }
    value.appendChild(toastXml.createTextNode(text));
});

// Create a toast notification from the XML, then create a ToastNotifier object
// to send the toast.
var toast = new notifications.ToastNotification(toastXml);

notificationManager.createToastNotifier().show(toast);

Comentarios

Envío de notificaciones del sistema desde aplicaciones de escritorio

Por lo general, enviar una notificación del sistema desde una aplicación de escritorio es la misma que enviarla desde una aplicación para UWP. Sin embargo, debe tener en cuenta estas diferencias y requisitos:

• Para que una aplicación de escritorio muestre una notificación del sistema, la aplicación debe tener un acceso directo en la pantalla Inicio.
• El acceso directo debe tener un AppUserModelID.
• Las aplicaciones de escritorio no pueden programar una notificación del sistema.

Para más información, consulte los temas siguientes:

• Cómo habilitar las notificaciones del sistema del escritorio a través de AppUserModelID
• Inicio rápido: Envío de una notificación del sistema desde el escritorio

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	ConfigureNotificationMirroring
1607	14393	GetForUser
1703	15063	GetDefault

Propiedades

History

Obtiene el objeto ToastNotificationHistory .

Métodos

ConfigureNotificationMirroring(NotificationMirroring)	Especifica si se permite la creación de reflejo de notificaciones. La creación de reflejo de notificaciones permite que una notificación se difunda en varios dispositivos.
CreateToastNotifier()	Crea e inicializa una nueva instancia de ToastNotification, enlazada a la aplicación que realiza la llamada, que permite generar una notificación del sistema a esa aplicación.
CreateToastNotifier(String)	Crea e inicializa una nueva instancia de ToastNotification, enlazada a una aplicación especificada, normalmente otra aplicación del mismo paquete.
GetDefault()	Obtiene un administrador de notificaciones del sistema para el usuario actual.
GetForUser(User)	Obtiene un administrador de notificaciones del sistema para el usuario especificado.
GetTemplateContent(ToastTemplateType)	Obtiene el contenido XML de una de las plantillas del sistema predefinidas para poder personalizarlo para su uso en la notificación.

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
• Introducción a las notificaciones del sistema
• 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