ScheduledToastNotification Classe

Definição

Namespace:

Windows.UI.Notifications

Contém o XML que define a notificação do sistema que será exibida no horário agendado.

public ref class ScheduledToastNotification 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.IScheduledToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ScheduledToastNotification 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.IScheduledToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ScheduledToastNotification

function ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)

Public NotInheritable Class ScheduledToastNotification

Herança

Object Platform::Object IInspectable ScheduledToastNotification

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)

Exemplos

O exemplo a seguir mostra uma notificação do sistema agendada para exibição em uma hora.

var Notifications = Windows.UI.Notifications;
var currentTime = new Date();
var seconds = 60;
var dueTime = new Date(currentTime.getTime() + seconds * 60 * 1000);
var idNumber = Math.floor(Math.random() * 100000000);  // Generates a unique ID number for the notification.

// Set up the notification text.
var toastXml = Notifications.ToastNotificationManager.getTemplateContent(Notifications.ToastTemplateType.toastText02);
var strings = toastXml.getElementsByTagName("text");
strings[0].appendChild(toastXml.createTextNode(This is a scheduled toast notification));
strings[1].appendChild(toastXml.createTextNode("Received: " + dueTime.toLocaleTimeString()));

// Create the toast notification object.
var toast = new Notifications.ScheduledToastNotification(toastXml, dueTime);
toast.id = "Toast" + idNumber;

// Add to the schedule.
Notifications.ToastNotificationManager.createToastNotifier().addToSchedule(toast);

Comentários

Crie e inicialize uma nova instância desse objeto chamando ScheduledToastNotification.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	NotificationMirroring
1607	14393	RemoteId
1803	17134	ExpirationTime

Construtores

ScheduledToastNotification(XmlDocument, DateTime)

Cria e inicializa uma nova instância de um ScheduledToastNotification que será exibida apenas uma vez.

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Preterido em Windows 10. Em sistemas Windows 8, cria e inicializa uma nova instância de um ScheduledToastNotification que aparece novamente após um horário especificado após a exibição inicialmente. Em Windows 10, isso funciona equivalentemente a ScheduledToastNotification(XmlDocument, DateTime). Para obter o mesmo comportamento de intervalo de soneca em Windows 10, você pode usar botões em seus notificações.

Propriedades

Content	Obtém o XML que define essa notificação agendada do sistema.
DeliveryTime	Obtém a hora em que essa notificação do sistema está agendada para ser exibida.
ExpirationTime	Obtém ou define o tempo de expiração da notificação.
Group	Obtém ou define o identificador de grupo para a notificação.
Id	Obtém um valor especificado pelo desenvolvedor usado para identificar um sistema agendado específico.
MaximumSnoozeCount	Obtém o número máximo de vezes para exibir essa notificação.
NotificationMirroring	Obtém ou define um valor que especifica se o espelhamento de notificação está habilitado. (O espelhamento de notificação permite que uma notificação apareça em vários dispositivos.)
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.
SnoozeInterval	Obtém a quantidade de tempo entre as ocorrências da notificação.
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 uma cadeia de caracteres que identifica exclusivamente uma notificação do sistema dentro de um Grupo.

Confira também

• Exemplo de notificações agendadas
• Esquema de notificação do sistema
• Diretrizes e lista de verificação para notificações agendadas