Share via

ScheduledToastNotification Construtores

  • Referência

Definição

Namespace:
Windows.UI.Notifications

Sobrecargas

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 no 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. No Windows 10, isso funciona equivalentemente a ScheduledToastNotification(XmlDocument, DateTime). Para obter o mesmo comportamento de intervalo de soneca no Windows 10, você pode usar botões em seus notificações.

ScheduledToastNotification(XmlDocument, DateTime)

Editar

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

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime);
function ScheduledToastNotification(content, deliveryTime)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset)

Parâmetros

content
XmlDocument

O XML que define o conteúdo da notificação do sistema.

deliveryTime
DateTime DateTimeOffset

A data e a hora em que o Windows deve exibir a notificação do sistema. Você deve chamar AddToSchedule antes desta vez.

Exemplos

O exemplo a seguir mostra uma notificação do sistema agendada para exibição em uma hora, incluindo o uso desse construtor para criar a notificação.

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

Confira também

Aplica-se a

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Editar

Preterido no 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. No Windows 10, isso funciona equivalentemente a ScheduledToastNotification(XmlDocument, DateTime). Para obter o mesmo comportamento de intervalo de soneca no Windows 10, você pode usar botões em seus notificações.

public:
 ScheduledToastNotification(XmlDocument ^ content, DateTime deliveryTime, TimeSpan snoozeInterval, unsigned int maximumSnoozeCount);
 ScheduledToastNotification(XmlDocument const& content, DateTime const& deliveryTime, TimeSpan const& snoozeInterval, uint32_t const& maximumSnoozeCount);
public ScheduledToastNotification(XmlDocument content, System.DateTimeOffset deliveryTime, System.TimeSpan snoozeInterval, uint maximumSnoozeCount);
function ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)
Public Sub New (content As XmlDocument, deliveryTime As DateTimeOffset, snoozeInterval As TimeSpan, maximumSnoozeCount As UInteger)

Parâmetros

content
XmlDocument

O XML que define o conteúdo da notificação do sistema.

deliveryTime
DateTime DateTimeOffset

A data e hora em que o Windows deve primeiro exibir a notificação do sistema. Você deve chamar AddToSchedule antes desta vez.

snoozeInterval
TimeSpan TimeSpan

A quantidade de tempo entre as ocorrências da notificação. Para ser válido, esse valor não deve ser inferior a 60 segundos e não mais do que 60 minutos.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

O número máximo de vezes para exibir essa notificação. Os valores válidos variam de 1 a 5.

Exemplos

O exemplo a seguir mostra uma notificação do sistema agendada para exibição em uma hora, incluindo o uso desse construtor para criar a notificação, especificando um intervalo de adiamento de 60 segundos e um máximo de cinco vezes para mostrar a notificação.

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, 60 * 1000, 5);
toast.id = "Toast" + idNumber;

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

Comentários

Esse tipo de notificação de notificação de notificação agendada de intervalo de adiamento é boa para uma funcionalidade semelhante a um alarme de soneca. Por exemplo, a notificação pode ser exibida a cada cinco minutos até que a contagem máxima de adiamentos seja atingida, a menos que a notificação seja removida explicitamente do agendamento pelo aplicativo.

Importante

Seu aplicativo é responsável por remover a notificação da agenda depois que o usuário ativa a notificação por meio de um toque ou clique. Não fazer isso pode fazer com que a notificação seja exibida novamente até que a contagem máxima de adiamentos seja atingida, mesmo que o usuário já tenha lidado com ela.

Se você quiser agendar intervalos de adiamento longos, como meses ou anos, recomendamos que você use notificações agendadas individuais em vez desse método. Isso evitará erros de tempo causados pelo horário de verão ou anos bissextos.

O código a seguir mostra uma chamada para esse método que exibe uma notificação do sistema começando em myData a cada cinco minutos por um máximo de três vezes.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

Confira também

Aplica-se a