ToastNotification Classe

Definição

Namespace:

Windows.UI.Notifications

Define o conteúdo, os metadados e os eventos associados e o tempo de expiração de uma notificação do sistema.

public ref class ToastNotification sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification

function ToastNotification(content)

Public NotInheritable Class ToastNotification

Herança

Object Platform::Object IInspectable ToastNotification

Atributos

ActivatableAttribute 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)

Comentários

Para obter diretrizes de instruções para implementar notificações do sistema em seu aplicativo, consulte Enviar uma notificação do sistema local de aplicativos C#.

Diretrizes para lidar com a ativação do aplicativo para notificações do sistema:

• Os aplicativos UWP devem usar o OnActivated para lidar com ativações do sistema.
• A partir do WinRT Build 19041, os aplicativos empacotados (incluindo aplicativos empacotados com local externo) podem usar ToastNotificationActionTrigger para lidar com ativações para obter mais detalhes.
• Os aplicativos da área de trabalho podem usar a ativação COM seguindo Desktop – Enviar Notificação Local.
• Se nenhuma das opções de ativação se ajustar ao aplicativo, siga o exemplo neste documento para usar corretamente manipuladores de eventos.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	Dados
1703	15063	Prioridade
1903	18362	ExpiresOnReboot

Construtores

ToastNotification(XmlDocument)

Cria e inicializa uma nova instância do ToastNotification.

Propriedades

Content	Obtém o XML que define a notificação do sistema atual.
Data	Obtém ou define informações adicionais sobre o status da notificação do sistema.
ExpirationTime	Obtém ou define o tempo após o qual uma notificação do sistema não deve ser exibida.
ExpiresOnReboot	Indica se a notificação do sistema permanecerá no Centro de Notificação após uma reinicialização.
Group	Obtém ou define o identificador de grupo para a notificação.
NotificationMirroring	Obtém ou define um valor que especifica se o espelhamento de notificação é permitido.
Priority	Obtém ou define a prioridade da notificação do sistema.
RemoteId	Obtém ou define uma ID remota para a notificação que permite ao sistema correlacionar essa notificação com outra gerada em outro dispositivo.
SuppressPopup	Obtém ou define se a interface do usuário pop-up de um sistema é exibida na tela do usuário.
Tag	Obtém ou define o identificador exclusivo dessa notificação dentro do Grupo de notificação.

Eventos

Activated	Ocorre quando o usuário ativa uma notificação do sistema por meio de um clique ou toque. Os aplicativos que estão em execução assinam este evento.
Dismissed	Ocorre quando uma notificação do sistema sai da tela, expirando ou sendo explicitamente ignorada pelo usuário. Os aplicativos que estão em execução assinam este evento.
Failed	Ocorre quando um erro é causado quando o Windows tenta gerar uma notificação do sistema. Os aplicativos que estão em execução assinam este evento.

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
• Blocos, selos e notificações
• 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