视觉对象 (磁贴架构)

包含多个 绑定 子元素,其中每个元素定义一个磁贴。

元素层次结构

<tile>
<可视>

语法

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

  <!-- Child elements -->
  binding+

</visual>

密钥

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

特性和元素

特性

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

设置为 true 以允许 Windows 将查询字符串追加到磁贴通知中提供的图像 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
contentId

设置为唯一标识通知内容的发件人定义的字符串。 这可以防止在大型磁贴模板显示最后三个宽磁贴通知的情况下重复。

字符串

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

字符串
version

开发此特定有效负载的磁贴 XML 架构的版本。 它可以有两个值,1 或 2。 版本 1 需要Windows 8架构下的有效有效负载。 版本 2 可识别新的大型磁贴模板、现有模板的新Windows 8.1模板名称和绑定元素的回退属性。

integer 1

 

子元素

子元素 说明
binding

指定磁贴模板。 对于每个受支持的磁贴大小,每个通知都应包含一个绑定元素。

 

父元素

父元素 说明
tile

基磁贴元素,其中包含单个 可视 元素。

 

注解

下表说明了系统在未指定 lang 时如何响应。

预测... 系统响应
通知的语言
  • 如果显式设置,请使用 visual.lang 或 binding.lang
  • 否则,应用特定语言设置 ([资源管理系统] (/previous-versions/windows/apps/jj552947 (v=win.10) ) 确定应用将以给定当前语言配置文件)
  • 否则,磁贴上显示名称的语言由 Windows 运行时
  • 否则,Shell 的 UI 语言 (MUI 语言)

此语言主要影响包含列的模板中列的布局。

包含文本文本的文本元素
  • 如果显式设置,请使用 visual.lang 或 binding.lang
  • 否则,应用特定语言设置 ([资源管理系统] (/previous-versions/windows/apps/jj552947 (v=win.10) ) 确定应用将以给定当前语言配置文件)
  • 否则,磁贴上显示名称的语言由 Windows 运行时
  • 否则 shell 的 UI 语言 (MUI 语言)
包含 ms-resource 内容的文本元素
  • 如果显式设置,请使用 visual.lang 或 binding.lang,并且显式语言将追加到用于解析字符串的资源管理系统的 [ResourceContext] (/previous-versions/windows/apps/jj552947 (v=win.10) #resourcecontext) 的语言列表
  • 否则,[ResourceContext] (/previous-versions/windows/apps/jj552947 (v=win.10) #resourcecontext) 使用作为用户语言配置文件初始化

解析字符串后,解析字符串的语言将分配给文本元素。 此语言塑造了 LTR 与 RTL (UI) 和字体选择的文本对齐方式。

ms-appx:/// image
  • 如果显式设置,请使用 visual.lang 或 binding.lang,显式语言将附加到资源管理系统的 [ResourceContext] (/previous-versions/windows/apps/jj552947 (v=win.10) #resourcecontext) 用于解析字符串的语言列表
  • 否则,[ResourceContext] (/previous-versions/windows/apps/jj552947 (v=win.10) #resourcecontext) 我们用作对用户的语言配置文件进行初始化
云映像
  • 如果显式设置,请使用 visual.lang 或 binding.lang
  • 否则,应用特定的语言设置 ([资源管理系统] (/previous-versions/windows/apps/jj552947 (v=win.10) ) 确定应用将以给定当前语言配置文件)
  • 否则,如果名称与语言无关,则可能不会设置Windows 运行时 (解析的磁贴上显示名称的语言)
  • 否则,Shell 的 UI 语言 (MUI 语言)

如果 addImageQuery 为 true,则此语言包含在查询字符串中。

 

要求

Namespace http://schemas.microsoft.com/notifications/2012/tile.xsd