visual (Toast XML 架构)

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

元素层次结构

<吐 司>
<可视>

语法

<visual version?       = integer
        lang?          = string
        baseUri?       = anyURI
        branding?      = "none" | "logo" | "name"
        addImageQuery? = boolean >

  <!-- Child elements -->
  binding+

</visual>

密钥

? 可选 ( (一个或多个) + 需要零) 或一个)

特性和元素

特性

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

设置为“true”以允许 Windows 将查询字符串追加到 Toast 通知中提供的图像 URI。 如果你的服务器托管图像并且可以处理查询字符串,则可通过基于查询字符串搜索图像变量,或通过忽略查询字符串并且不带查询字符串按指定方式返回图像,来使用此特性。 此查询字符串指定比例、对比度设置和语言;例如,值为

“www.website.com/images/hello.png”

通知中的给定变为

“www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us”

boolean false
baseUri

与图像源属性中的相对 URI 组合的默认基 URI。

anyURI ms-appx:///
品牌

未使用。

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

  • 徽标
  • name

XML 有效负载的目标区域设置,指定为 BCP-47 语言标记 ,例如“en-US”或“fr-FR”。 此区域设置由 绑定文本中指定的任何区域设置替代。 如果此值为文字字符串,则此属性默认为用户的用户界面语言。 如果此值为字符串参考,则此属性默认为解析字符串时由 Windows 运行时选择的区域设置。

字符串
version

开发此特定有效负载的 toast XML 架构的版本。

integer 1

 

子元素

子元素 说明
binding

指定 toast 模板。 请注意,Toast 通知中只能包含一个绑定元素。

 

父元素

父元素 说明
toast

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

另请参阅