ToastNotification Класс

Определение

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

Windows.UI.Notifications

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

public ref class ToastNotification 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.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification 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.IToastNotificationFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ToastNotification

function ToastNotification(content)

Public NotInheritable Class ToastNotification

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

Object Platform::Object IInspectable ToastNotification

Атрибуты

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)

Комментарии

Инструкции по реализации всплывающих уведомлений в приложении см. в статье Отправка локального всплывающего уведомления из приложений C#.

Руководство по обработке активации приложения для всплывающих уведомлений:

• Приложения UWP должны использовать OnActivated для обработки всплывающих активаций.
• Начиная со сборки WinRT 19041, упакованные приложения (включая упакованные приложения с внешним расположением) могут использовать ToastNotificationActionTrigger для обработки активаций для получения дополнительных сведений.
• Классические приложения могут использовать com-активацию, выполнив команду Desktop — Send Local Toast ( Отправить локальное всплывающее уведомление).
• Если ни один из вариантов активации не подходит вашему приложению, следуйте примеру в этом документе, чтобы правильно использовать обработчики событий.

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

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	NotificationMirroring
1607	14393	RemoteId
1703	15063	Данные
1703	15063	Приоритет
1903	18362	ExpiresOnReboot

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

ToastNotification(XmlDocument)

Создает и инициализирует новый экземпляр ToastNotification.

Свойства

Content	Возвращает XML-код, определяющий текущее всплывающее уведомление.
Data	Возвращает или задает дополнительные сведения о состоянии всплывающего уведомления.
ExpirationTime	Возвращает или задает время, по истечении которого всплывающее уведомление не должно отображаться.
ExpiresOnReboot	Указывает, останется ли всплывающее уведомление в центре уведомлений после перезагрузки.
Group	Возвращает или задает идентификатор группы для уведомления.
NotificationMirroring	Возвращает или задает значение, указывающее, разрешено ли зеркальное отображение уведомлений.
Priority	Возвращает или задает приоритет всплывающего уведомления.
RemoteId	Возвращает или задает удаленный идентификатор уведомления, который позволяет системе сопоставлять это уведомление с другим уведомлением, созданным на другом устройстве.
SuppressPopup	Возвращает или задает значение, указывающее, отображается ли всплывющий пользовательский интерфейс всплывающего уведомления на экране пользователя.
Tag	Возвращает или задает уникальный идентификатор этого уведомления в группе уведомлений.

События

Activated	Происходит, когда пользователь активирует всплывающее уведомление щелчком или касанием. Приложения, которые выполняются, подписываются на это событие.
Dismissed	Происходит, когда всплывающее уведомление покидает экран по истечении срока действия или явно закрывается пользователем. Приложения, которые выполняются, подписываются на это событие.
Failed	Возникает при возникновении ошибки при попытке Windows создать всплывающее уведомление. Приложения, которые выполняются, подписываются на это событие.

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

• Пример всплывающих уведомлений
• Отправка всплывающих уведомлений из примера классического приложения
• Xml-схема всплывающего уведомления
• Плитки, индикаторы событий и уведомления
• Краткое руководство. Отправка всплывающего уведомления
• Краткое руководство. Отправка всплывающего push-уведомления
• Краткое руководство. Отправка всплывающего уведомления с рабочего стола
• Рекомендации и контрольный список для всплывающих уведомлений
• Обработка активации из всплывающего уведомления
• Как согласиться на всплывающие уведомления
• Планирование всплывающего уведомления
• Включение всплывающих уведомлений рабочего стола через AppUserModelID
• Каталог шаблонов всплывающих уведомлений
• Параметры всплывающего уведомления о звуке