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


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

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

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

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

Синтаксис

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

Ключ

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

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

Атрибуты

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

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

None

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

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

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