绑定 (Toast XML 架构)

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

元素层次结构

<吐 司>

<可视>

<binding>

语法

<binding template       = "ToastGeneric"
         fallback?      = string
         lang?          = string
         addImageQuery? = boolean
         baseUri?       = anyURI
         branding?      = string >

  <!-- Child elements -->
  ( image
  | text
  | group
  | progress
  )*

</binding>

密钥

? 可选 (零或一个) * 可选 (零个或多个)

特性和元素

特性

属性	说明	数据类型	必须	默认值
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	否	无
fallback	找不到主模板时要使用的模板，用于向后兼容。	字符串	否	无
朗	XML 有效负载的目标区域设置，指定为 BCP-47 语言标记 ，例如“en-US”或“fr-FR”。 此处指定的区域设置将替代 视觉对象中的区域设置，但 文本中的区域设置可以替代该区域设置。 如果此值为文字字符串，则此属性默认为用户的用户界面语言。 如果此值为字符串参考，则此属性默认为解析字符串时由 Windows 运行时选择的区域设置。	字符串	否	无
template	此值必须设置为“ToastGeneric”	字符串	是	无

 

子元素

子元素	说明
图像	指定 Toast 模板中使用的图像。
text	指定 Toast 模板中使用的文本。
group	语义上标识组中的内容必须作为一个整体显示，或者如果无法容纳，则不显示。 组还允许创建多个列。
进度	指定 Toast 模板中使用的文本。

 

父元素

父元素	说明
视觉	包含定义 toast 的单个 绑定 元素。

 

另请参阅

• Toast 内容
• 通知可视化工具