Compartilhar via


ScheduledToastNotification Classe

Definição

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

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.

Aplica-se a

Confira também