всплывающее уведомление (xml-схема всплывающего уведомления)

Статья
09/03/2023

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

Иерархия элементов

<Тост>

Синтаксис

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

Ключ

? необязательный (ноль или единица)

Атрибуты и элементы

Атрибуты

Атрибут	Описание	Тип данных	Обязательно	Значение по умолчанию
duration	Время, в течение которого должно отображаться всплывающее уведомление.	Этот атрибут может иметь одно из следующих значений: long short	Нет	None
Запуска	Строка, которая передается в приложение, когда оно активируется всплывающим уведомлением. Формат и содержимое этой строки определяются приложением для собственного использования. Когда пользователь касается всплывающего уведомления или щелкает его, чтобы запустить связанное с ним приложение, строка запуска предоставляет приложению контекст, позволяющий отобразить для пользователя представление, связанное с содержимым всплывающего уведомления, а не то представление, которое появляется при стандартном запуске приложения.	строка	Нет	None
displayTimestamp	Представлено в Creators Update: переопределяет метку времени по умолчанию пользовательской меткой времени, представляющей время фактической доставки содержимого уведомления, а не время получения уведомления платформой Windows. Это значение должно быть строковым форматом в соответствии со стандартом ISO 8601.	строка	Нет	None
scenario	Сценарий, для котором используется всплывающее уведомление, например будильник или напоминание. "напоминание" — уведомление с напоминанием. Оно будет отображаться предварительно расширенным и будет оставаться на экране пользователя до закрытия. Обратите внимание, что это действие будет игнорироваться без уведомления, если не будет активирована кнопка всплывающего уведомления в фоновом режиме. "alarm" — оповещение о тревоге. Оно будет отображаться предварительно расширенным и будет оставаться на экране пользователя до закрытия. Звук будет воспроизводиться по умолчанию и будет использоваться как звук будильника. "incomingCall" — уведомление о входящем вызове. Оно будет отображаться предварительно развернутым в формате специального вызова и будет оставаться на экране пользователя до закрытия. Звук будет воспроизводиться по умолчанию и будет использоваться как мелодия звонка. "urgent" — важное уведомление. Это позволяет пользователям более контролировать, какие приложения могут отправлять им высокоприоритетные всплывающие уведомления, которые могут прерывать фокусировку (не беспокоить). Это можно изменить в параметрах уведомлений.	строка	Нет	None
useButtonStyle	Указывает, следует ли использовать стилистированные кнопки. Стиль кнопки определяется атрибутом hint-buttonStyle элемента action .	Логическое	Нет	false

Дочерние элементы

Дочерний элемент	Описание
звук	Указывает звук, воспроизводимый при отображении всплывающего уведомления. Этот элемент также позволяет отключить звук любого всплывающего уведомления.
commands	Указывает, что всплывающее уведомление используется для указания входящего вызова или будильника с соответствующими командами, связанными с каждым сценарием.
Visual	Содержит один элемент привязки , определяющий всплывающее уведомление.
actions	Элемент Container для объявления до пяти входных данных и до пяти действий кнопки для всплывающего уведомления.
авторизации	Представлено в обновлении Creators Update. Задает пользовательский заголовок, который группирует несколько уведомлений в центре уведомлений.

Родительские элементы

Этот внешний элемент (document) может не содержаться в других элементах.