Compartir a través de

ToastNotificationManager.CreateToastNotifier Método

  • Referencia

Definición

Espacio de nombres:
Windows.UI.Notifications

Sobrecargas

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 en el mismo paquete.

CreateToastNotifier()

Editar

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.

public:
 static ToastNotifier ^ CreateToastNotifier();
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
 static ToastNotifier CreateToastNotifier();
[Windows.Foundation.Metadata.Overload("CreateToastNotifier")]
public static ToastNotifier CreateToastNotifier();
function createToastNotifier()
Public Shared Function CreateToastNotifier () As ToastNotifier

Devoluciones

ToastNotifier

El objeto que usarás para enviar la notificación del sistema a la aplicación.

Atributos
OverloadAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo crear y enviar una notificación del sistema que incluya texto e imágenes, incluido el uso del método 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

No use esta sobrecarga al crear un notificador del sistema para una aplicación de escritorio. Use CreateToastNotifier(appID) para proporcionar el appUserModelID necesario.

Si la aplicación usa un agente de protocolo de voz a través de Internet (VOIP) en segundo plano, debe especificar el identificador de la aplicación para mostrar una notificación del sistema. Use la sobrecarga del método CreateToastNotifier(appID ).

Consulte también

Se aplica a

CreateToastNotifier(String)

Editar

Crea e inicializa una nueva instancia de ToastNotification, enlazada a una aplicación especificada, normalmente otra aplicación en el mismo paquete.

public:
 static ToastNotifier ^ CreateToastNotifier(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
 static ToastNotifier CreateToastNotifier(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("CreateToastNotifierWithId")]
public static ToastNotifier CreateToastNotifier(string applicationId);
function createToastNotifier(applicationId)
Public Shared Function CreateToastNotifier (applicationId As String) As ToastNotifier

Parámetros

applicationId
String

Platform::String

winrt::hstring

Identificador único de la aplicación.

Nota:

No puede enviar una notificación del sistema a un icono secundario, por lo que debe ser el identificador de un icono de la aplicación.

Devoluciones

ToastNotifier

El objeto que usará para enviar la notificación del sistema al icono.

Atributos
OverloadAttribute

Comentarios

La aplicación identificada por applicationId debe pertenecer al mismo paquete que el autor de la llamada.

Use este formato del método si la aplicación usa un agente de protocolo de voz a través de Internet (VOIP) en segundo plano, para especificar el identificador de aplicación necesario para mostrar una notificación del sistema en ese caso.

Envío de notificaciones del sistema desde aplicaciones de escritorio

Por lo general, el envío de una notificación del sistema desde una aplicación de escritorio es el mismo que el envío 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:

Consulte también

Se aplica a