Поделиться через


ScheduledToastNotification Класс

Определение

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

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
Наследование
Object Platform::Object IInspectable ScheduledToastNotification
Атрибуты

Требования к 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

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

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

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