ToastNotification Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет содержимое, связанные метаданные и события, а также время окончания срока действия всплывающего уведомления.
public ref class ToastNotification sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Notifications.IToastNotificationFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class ToastNotification 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.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class ToastNotification 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.IToastNotificationFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ToastNotification final
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Notifications.IToastNotificationFactory), 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 ToastNotification
[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")]
public sealed class ToastNotification
[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
- Наследование
- Атрибуты
Требования к 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
- Каталог шаблонов всплывающих уведомлений
- Параметры всплывающего уведомления о звуке