action (toast XML Schema)

Указывает кнопку, отображаемую в всплывающем тонаторе.

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

<Тост>
<Действия>
<Вход>

Синтаксис

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

Ключ

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
содержимое Содержимое, отображаемое на кнопке. строка Да Нет
аргументы Определяемая приложением строка аргументов, которую приложение будет получать позже, если пользователь нажмет эту кнопку. строка Да Нет
тип Строка аргумента, которую можно передать связанному приложению, чтобы предоставить конкретные сведения о действии, которое должно выполняться в ответ на действие пользователя. строка Да Нет
activationType Определяет тип активации, который будет использоваться, когда пользователь взаимодействует с определенным действием.
  • "передний план" — значение по умолчанию. Ваше приложение переднего плана запущено.
  • "background" — активируется соответствующая фоновая задача, и вы можете выполнять код в фоновом режиме, не прерывая работу пользователя.
  • "протокол" — запуск другого приложения с помощью активации протокола.
строка Нет "передний план"
расположение Если задано значение contextMenu, действие становится действием контекстного меню, добавленным в контекстное меню всплывающего уведомления, а не традиционной кнопкой всплывающего уведомления. строка Нет None
imageUri Универсальный код ресурса (URI) источника изображения для значка всплывающей кнопки. Эти значки являются белыми прозрачными изображениями 16 x 16 пикселей при масштабировании на 100 % и не должны включать в себя заполнение. Если вы решили показывать значки на всплывающем уведомлении, то следует указать значки для ВСЕХ кнопок уведомления, так как в таком случае стиль кнопок меняется на «кнопки со значками». Используйте один из следующих обработчиков протокола:
  • http:// или https:// — веб-образ.
  • ms-appx:/// — образ, включенный в пакет приложения.
  • ms-appdata:///local/ — образ, сохраненный в локальном хранилище.
  • file:/// — локальный образ. (Поддерживается только для классических приложений. Этот протокол не может использоваться приложениями UWP.)
строка Нет None
hint-inputId Задайте идентификатор входных данных для размещения кнопки рядом с входным значением. строка Нет None
hint-buttonStyle Стиль кнопки. параметр useButtonStyle должен иметь значение true в элементе всплывающего уведомления .
  • "Успех" — кнопка зеленая
  • "Критическое" — кнопка красная.
Обратите внимание, что в этих значениях учитывается регистр.
строка Нет None
подсказка и подсказка Подсказка для кнопки, если у кнопки есть пустая строка содержимого. строка Нет None

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

Нет

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

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

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