Compartir a través de

ToastNotificationManager Clase

  • Referencia

Definición

Espacio de nombres:
Windows.UI.Notifications
Editar

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)]
class ToastNotificationManager final
/// [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)]
public static class ToastNotificationManager
[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:

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.

Se aplica a

Consulte también