Share via

ScheduledToastNotification Конструкторы

  • Ссылка

Определение

Пространство имен:
Windows.UI.Notifications

Перегрузки

ScheduledToastNotification(XmlDocument, DateTime)

Создает и инициализирует новый экземпляр ScheduledToastNotification , который будет отображаться только один раз.
ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Не рекомендуется в Windows 10. В системах Windows 8 создает и инициализирует новый экземпляр ScheduledToastNotification , который появляется через указанное время после первоначального появления. В Windows 10 эти функции эквивалентны ScheduledToastNotification(XmlDocument, DateTime). Чтобы обеспечить такое же поведение интервала отложений в Windows 10, можно использовать кнопки на всплываемых уведомлениях.

ScheduledToastNotification(XmlDocument, DateTime)

Изменить

Создает и инициализирует новый экземпляр ScheduledToastNotification , который будет отображаться только один раз.

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)

Параметры

content
XmlDocument

XML-код, определяющий содержимое всплывающего уведомления.

deliveryTime
DateTime DateTimeOffset

Дата и время отображения всплывающего уведомления в Windows. До этого времени необходимо вызвать AddToSchedule .

Примеры

В следующем примере показано всплывающее уведомление, которое будет отображаться в течение одного часа, включая использование этого конструктора для создания уведомления.

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

См. также раздел

Применяется к

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

Изменить

Не рекомендуется в Windows 10. В системах Windows 8 создает и инициализирует новый экземпляр ScheduledToastNotification , который появляется через указанное время после первоначального появления. В Windows 10 эти функции эквивалентны ScheduledToastNotification(XmlDocument, DateTime). Чтобы обеспечить такое же поведение интервала отложений в Windows 10, можно использовать кнопки на всплываемых уведомлениях.

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)

Параметры

content
XmlDocument

XML-код, определяющий содержимое всплывающего уведомления.

deliveryTime
DateTime DateTimeOffset

Дата и время, когда Windows должна впервые отобразить всплывающее уведомление. До этого времени необходимо вызвать AddToSchedule .

snoozeInterval
TimeSpan TimeSpan

Время между вхождениями уведомления. Чтобы быть допустимым, это значение должно быть не менее 60 секунд и не более 60 минут.

maximumSnoozeCount
UInt32

unsigned int

uint32_t

Максимальное количество раз для отображения этого уведомления. Допустимые значения в диапазоне от 1 до 5.

Примеры

В следующем примере показано всплывающее уведомление, которое будет отображаться в течение одного часа, включая использование этого конструктора для создания уведомления, указав интервал отложений в 60 секунд и максимум пять раз для отображения уведомления.

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

Комментарии

Этот тип запланированного всплывающего уведомления с интервалом откладывания подходит для функции, подобной будильнику. Например, уведомление может отображаться каждые пять минут до тех пор, пока не будет достигнуто максимальное число отложенных, если ваше приложение не явным образом не удаляет уведомление из расписания.

Важно!

Ваше приложение отвечает за удаление уведомления из расписания, когда пользователь активирует уведомление касанием или щелчком мыши. В противном случае уведомление может появиться снова, пока не будет достигнуто максимальное количество отложенных попыток, даже если пользователь уже имел дело с ним.

Если вы хотите запланировать длительные интервалы отложений, например месяцы или годы, рекомендуется использовать отдельные запланированные уведомления, а не этот метод. Это позволит избежать ошибок времени, вызванных переходом на летнее время или високосные годы.

В следующем коде показан вызов этого метода, который отображает всплывающее уведомление, начинающееся с myData , каждые пять минут максимум три раза.

new ScheduledToastNotification(toast1, myDate, 60000, 3)

См. также раздел

Применяется к