Compartilhar via

ToastNotificationManager.CreateToastNotifier Método

  • Referência

Definição

Namespace:
Windows.UI.Notifications

Sobrecargas

CreateToastNotifier()

Cria e inicializa uma nova instância do ToastNotification, associada ao aplicativo de chamada, que permite gerar uma notificação do sistema para esse aplicativo.
CreateToastNotifier(String)

Cria e inicializa uma nova instância do ToastNotification, associada a um aplicativo especificado, geralmente outro aplicativo no mesmo pacote.

CreateToastNotifier()

Editar

Cria e inicializa uma nova instância do ToastNotification, associada ao aplicativo de chamada, que permite gerar uma notificação do sistema para esse aplicativo.

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

Retornos

ToastNotifier

O objeto que você usará para enviar a notificação do sistema para o aplicativo.

Atributos
OverloadAttribute

Exemplos

O exemplo a seguir mostra como criar e enviar uma notificação do sistema que inclui texto e imagens, incluindo o uso do 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);

Comentários

Não use essa sobrecarga ao criar um notificador do sistema para um aplicativo da área de trabalho. Use CreateToastNotifier(appID) para fornecer o AppUserModelID necessário.

Se o aplicativo usar um agente voIP (protocolo VOIP) em segundo plano, ele deverá especificar a ID do aplicativo para mostrar uma notificação do sistema. Use a sobrecarga do método CreateToastNotifier(appID ).

Confira também

Aplica-se a

CreateToastNotifier(String)

Editar

Cria e inicializa uma nova instância do ToastNotification, associada a um aplicativo especificado, geralmente outro aplicativo no mesmo pacote.

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

A ID exclusiva do aplicativo.

Observação

Você não pode enviar uma notificação do sistema para um bloco secundário, portanto, essa deve ser a ID de um bloco do aplicativo.

Retornos

ToastNotifier

O objeto que você usará para enviar a notificação do sistema para o bloco.

Atributos
OverloadAttribute

Comentários

O aplicativo identificado por applicationId deve pertencer ao mesmo pacote que o chamador.

Use essa forma do método se o aplicativo usar um agente voIP (protocolo VOIP) em segundo plano para especificar a ID do aplicativo necessária para mostrar uma notificação do sistema nesse caso.

Enviar notificações do sistema de aplicativos da área de trabalho

Em geral, enviar uma notificação do sistema de um aplicativo da área de trabalho é o mesmo que enviá-la de um aplicativo UWP. No entanto, você deve estar ciente dessas diferenças e requisitos:

  • Para que um aplicativo da área de trabalho exiba uma notificação do sistema, o aplicativo deve ter um atalho na tela Inicial.
  • O atalho deve ter um AppUserModelID.
  • Os aplicativos da área de trabalho não podem agendar uma notificação do sistema.

Para saber mais, consulte esses tópicos:

Confira também

Aplica-se a