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


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

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

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

<Тост>

Синтаксис

<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) может не содержаться в других элементах.

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