Compartilhar via


ToastNotification Classe

Definição

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.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotification final
/// [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")]
class ToastNotification final
/// [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.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class ToastNotification
[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")]
public sealed class ToastNotification
[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

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.

Aplica-se a

Confira também