通过

操作 (Toast XML 架构)

  • 项目

指定 Toast 中显示的按钮。

元素层次结构

<吐 司>
<行动>
<输入>

语法

<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 指定当用户在 Toast 上执行操作时 Toast 应使用的行为。
  • “default” - 默认值。 当用户在 Toast 上执行操作时将消除 Toast。
  • “pendingUpdate”- 用户单击 Toast 上的按钮后，通知将保持存在，处于“挂起的更新”视觉状态。 应立即从后台任务更新 Toast，以便用户不会长时间看到此“挂起的更新”视觉状态。
 字符串 否 "default"
放置 设置为“contextMenu”时，该操作将成为添加到 Toast 通知上下文菜单的上下文菜单操作，而不是传统的 Toast 按钮。 字符串 否 无
imageUri Toast 按钮图标的图像源的 URI。 这些图标是 100% 缩放的白色透明 16x16 像素图像，图像本身中不应包含任何填充。 如果选择在一条 Toast 通知上提供图标，则必须为该通知中的所有按钮提供图标，因为该操作会将按钮样式转换为图标按钮。 使用以下协议处理程序之一：
  • http:// 或 https:// - 基于 Web 的图像。
  • ms-appx：/// - 应用包中包含的图像。
  • ms-appdata：///local/ - 保存到本地存储的图像。
  • file:/// - 本地映像。 (仅支持桌面应用。UWP apps 不能使用此协议。)
字符串 否 无
hint-inputId 将 设置为 输入 的 ID 以定位输入旁边的按钮。 字符串 否 无
hint-buttonStyle 按钮样式。 在 toast 元素中，useButtonStyle 必须设置为 true。
  • “成功”- 按钮为绿色
  • “关键”- 按钮为红色。
请注意，这些值区分大小写。		 字符串 否 无
hint-toolTip 按钮的工具提示（如果按钮包含空内容字符串）。 字符串 否 无

子元素

无

父元素

父元素 说明
actions 容器元素，用于声明最多 5 个输入和最多 5 个按钮操作的 Toast 通知。

另请参阅