всплывающее уведомление (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

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

  • "напоминание" — уведомление с напоминанием. Оно будет отображаться предварительно расширенным и будет оставаться на экране пользователя до закрытия.
  • "тревога" — уведомление о тревоге. Оно будет отображаться предварительно расширенным и будет оставаться на экране пользователя до закрытия. Звук будет воспроизводиться по умолчанию и будет использоваться как звук будильника.
  • "incomingCall" — уведомление о входящих звонках. Оно будет отображаться предварительно развернутым в формате специального вызова и будет оставаться на экране пользователя до закрытия. Звук будет воспроизводиться по умолчанию и будет использоваться как мелодия звонка.
  • "срочно" — важное уведомление. Это позволяет пользователям более контролировать, какие приложения могут отправлять им всплывающие уведомления с высоким приоритетом, которые могут прерывать фокус-поддержку (не беспокоить). Это можно изменить в параметрах уведомлений.

строка Нет None
useButtonStyle

Указывает, следует ли использовать стилированные кнопки. Стилизация кнопки определяется атрибутом **hint-buttonStyle** элемента [action](element-action.md).

Логическое Нет false

 

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

Дочерний элемент Описание
звук

Задает звук для воспроизведения при отображении всплывающего уведомления. Этот элемент также позволяет отключить звук всплывающего уведомления.

commands

Указывает, что всплывающее уведомление используется для указания входящего звонка или сигнализации с соответствующими командами, связанными с каждым сценарием.

Visual

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

actions

Элемент контейнера для объявления до пяти входных данных и до пяти действий кнопки для всплывающего уведомления.

авторизации

Представлено в Creators Update. Задает пользовательский заголовок, который группирует несколько уведомлений в центре уведомлений.

 

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

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

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