视觉对象 (磁贴架构)

  • 项目

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

元素层次结构

<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