Compartilhar via


ToastNotificationManager Classe

Definição

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)]
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
Herança
Object Platform::Object IInspectable ToastNotificationManager
Atributos

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:

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.

Aplica-se a

Confira também