Share via

toast (Toast XML 架构)

  • 项目

基本 toast 元素，它至少包含一个 可视 元素。

元素层次结构

<吐 司>

语法

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

密钥

? 可选 (零个或一个)

特性和元素

特性

属性 说明 数据类型 必须 默认值
duration

Toast 应显示的时间量。

此属性可以具有以下值之一：

  • long
  • short
 否 无
launch

当应用程序由 Toast 激活时向其传递的字符串。 此字符串的格式和内容由应用根据其自身用途定义。 当用户点击或单击 Toast 来启动其关联应用时，启动字符串会向应用提供上下文，以允许该应用向用户显示与 Toast 内容相关的视图，而不是以其默认方式启动。

 字符串 否 无
displayTimestamp

在创意者更新中引入：使用自定义时间戳替代默认时间戳，该时间戳表示通知内容的实际传递时间，而不是 Windows 平台接收通知的时间。 此值必须是使用 ISO 8601 标准设置格式的字符串。

 字符串 否 无
scenario

Toast 用于的方案，例如警报或提醒。

  • “提醒” - 提醒通知。 这类通知将以预先展开的状态显示在用户屏幕上并一直显示，直至消失。 请注意，除非有在后台激活的 Toast 按钮操作，否则将以无提示方式忽略此操作。
  • “alarm” - 警报通知。 这类通知将以预先展开的状态显示在用户屏幕上并一直显示，直至消失。 音频在默认情况下将循环播放，并将使用警报音频。
  • “incomingCall” - 传入呼叫通知。 这将以特殊通话格式以预先展开的形式显示在用户屏幕上并一直显示，直至消失。 音频在默认情况下将循环播放，并将使用铃声音频。
  • “紧急”- 重要通知。 这使用户可以更好地控制哪些应用可以向他们发送高优先级 Toast 通知，这些通知可以突破专注助手 (请勿打扰) 。 这可以在通知设置中修改。

 字符串 否 无
useButtonStyle

指定是否应使用带样式的按钮。 按钮的样式由 action 元素的 hint-buttonStyle 属性决定。

 boolean 否 false

 

子元素

子元素 说明
audio

指定显示 Toast 通知时要播放的声音。 此元素还允许将任何 Toast 通知音频静音。
commands

指定 Toast 通知用于指示传入呼叫或警报，并与每个方案关联的相应命令。
视觉

包含定义 toast 的单个 绑定 元素。
actions

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

在 Creators Update 中引入。 指定在操作中心内将多个通知组合在一起的自定义标头。

 

父元素

此最外层 (文档) 元素不能包含在任何其他元素中。

另请参阅