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 ScheduledToastNotificationfunction ScheduledToastNotification(content, deliveryTime, snoozeInterval, maximumSnoozeCount)Public NotInheritable Class 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 |
Возвращает или задает строку, однозначно идентифицирующая всплывающее уведомление внутри группы. |