ScheduledToastNotification Класс

Определение

Пространство имен:

Windows.UI.Notifications

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

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

Наследование

Object Platform::Object IInspectable ScheduledToastNotification

Атрибуты

ActivatableAttribute ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

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

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.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	NotificationMirroring
1607	14393	RemoteId
1803	17134	ExpirationTime

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

ScheduledToastNotification(XmlDocument, DateTime)

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

ScheduledToastNotification(XmlDocument, DateTime, TimeSpan, UInt32)

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

Свойства

Content	Возвращает XML-код, определяющий это запланированное всплывающее уведомление.
DeliveryTime	Возвращает время запланированного отображения всплывающего уведомления.
ExpirationTime	Возвращает или задает время окончания срока действия уведомления.
Group	Возвращает или задает идентификатор группы для уведомления.
Id	Возвращает заданное разработчиком значение, используемое для идентификации определенного запланированного всплывающего уведомления.
MaximumSnoozeCount	Возвращает максимальное количество раз для отображения этого уведомления.
NotificationMirroring	Возвращает или задает значение, указывающее, включено ли зеркальное отображение уведомлений. (Зеркальное отображение уведомлений позволяет отображать уведомление на нескольких устройствах.)
RemoteId	Возвращает или задает удаленный идентификатор для уведомления, который позволяет системе сопоставлять это уведомление с другим, созданным на другом устройстве.
SnoozeInterval	Возвращает интервал времени между вхождениями уведомления.
SuppressPopup	Возвращает или задает значение, указывающее, отображается ли всплывающее уведомление на экране пользователя.
Tag	Возвращает или задает строку, однозначно идентифицирующая всплывающее уведомление внутри группы.

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

• Пример запланированных уведомлений
• Схема всплывающего уведомления
• Рекомендации и контрольный список для запланированных уведомлений