ToastNotificationManager Classe

Definição

Namespace:

Windows.UI.Notifications

Cria objetos ToastNotifier que você usa para gerar notificações do sistema. Essa classe também fornece acesso ao conteúdo XML dos modelos de sistema fornecidos para que você possa personalizar esse conteúdo para uso em suas notificações.

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

Herança

Object Platform::Object IInspectable ToastNotificationManager

Atributos

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

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

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

Geralmente, 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 um 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 um sistema.

Para saber mais, consulte esses tópicos:

• Como habilitar notificações do sistema de área de trabalho por meio de um AppUserModelID
• Início Rápido: Enviar uma notificação do sistema da área de trabalho

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	ConfigureNotificationMirroring
1607	14393	GetForUser
1703	15063	GetDefault

Propriedades

History

Obtém o objeto ToastNotificationHistory .

Métodos

ConfigureNotificationMirroring(NotificationMirroring)	Especifica se o espelhamento de notificação é permitido. O espelhamento de notificação permite que uma notificação seja transmitida em vários dispositivos.
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.
GetDefault()	Obtém um gerenciador de notificação do sistema para o usuário atual.
GetForUser(User)	Obtém um gerenciador de notificação do sistema para o usuário especificado.
GetTemplateContent(ToastTemplateType)	Obtém o conteúdo XML de um dos modelos de notificação predefinidos para que você possa personalizá-lo para uso em sua notificação.

Confira também

• Exemplo de notificações do sistema
• Exemplo de envio de notificações do sistema de aplicativos da área de trabalho
• Esquema XML do Sistema
• Visão geral da notificação do sistema
• Início Rápido: Enviar uma notificação do sistema
• Início Rápido: Enviar uma notificação por push do sistema
• Início Rápido: Enviar uma notificação do sistema da área de trabalho
• Diretrizes e lista de verificação para notificações do sistema
• Como lidar com a ativação de uma notificação do sistema
• Como aceitar notificações do sistema
• Como agendar uma notificação do sistema
• Como habilitar notificações do sistema de área de trabalho por meio de um AppUserModelID
• O catálogo de modelos do sistema
• Opções de áudio do sistema