绑定 (磁贴架构)

  • 项目

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

元素层次结构

<tile>
<可视>
<binding>

语法

<binding template       = tileTemplateNameV2
         fallback?      = tileTemplateNameV1
         lang?          = string
         baseUri?       = anyURI
         branding?      = "none" | "logo" | "name"
         addImageQuery? = boolean
         contentId?     = string >

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

</binding>

密钥

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

特性和元素

特性

属性 说明 数据类型 必须 默认值
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

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

 字符串 否
fallback

收件人无法识别主模板名称时要使用的模板，用于Windows 8兼容性。 此值是模板属性中值的Windows 8名称。 Windows 8后引入的新模板没有回退。

 tileTemplateNameV1 (请参阅备注) 否 无
朗

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

 字符串 否 无
template

提供用于基于磁贴的模板之一。 通常，开发人员应同时提供正方形和宽格式，每个格式作为单独的 绑定 元素。 有效条目是 tileTemplateType 枚举的成员。

 tileTemplateNameV2 (请参阅备注) 是 无

 

子元素

子元素 说明
图像

指定磁贴模板中使用的图像。 提供的图像应与该模板中特定模板或图像的大小和形状要求匹配。
text

指定磁贴模板中使用的文本。

 

父元素

父元素 描述
视觉

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

 

注解

模板属性中使用的 tileTemplateNameV2 值可以是以下字符串值之一。 有关每个模板的详细信息，请参阅 磁贴模板目录。

  • TileSquare150x150Block
  • TileSquare150x150Image
  • TileSquare150x150PeekImageAndText01
  • TileSquare150x150PeekImageAndText02
  • TileSquare150x150PeekImageAndText03
  • TileSquare150x150PeekImageAndText04
  • TileSquare150x150Text01
  • TileSquare150x150Text02
  • TileSquare150x150Text03
  • TileSquare150x150Text04
  • TileSquare310x310BlockAndText01
  • TileSquare310x310BlockAndText02
  • TileSquare310x310Image
  • TileSquare310x310ImageAndText01
  • TileSquare310x310ImageAndText02
  • TileSquare310x310ImageAndTextOverlay01
  • TileSquare310x310ImageAndTextOverlay02
  • TileSquare310x310ImageAndTextOverlay03
  • TileSquare310x310ImageCollection
  • TileSquare310x310ImageCollectionAndText01
  • TileSquare310x310ImageCollectionAndText02
  • TileSquare310x310SmallImagesAndTextList01
  • TileSquare310x310SmallImagesAndTextList02
  • TileSquare310x310SmallImagesAndTextList03
  • TileSquare310x310SmallImagesAndTextList04
  • TileSquare310x310Text01
  • TileSquare310x310Text02
  • TileSquare310x310Text03
  • TileSquare310x310Text04
  • TileSquare310x310Text05
  • TileSquare310x310Text06
  • TileSquare310x310Text07
  • TileSquare310x310Text08
  • TileSquare310x310TextList01
  • TileSquare310x310TextList02
  • TileSquare310x310TextList03
  • TileWide310x150BlockAndText01
  • TileWide310x150BlockAndText02
  • TileWide310x150Image
  • TileWide310x150ImageAndText01
  • TileWide310x150ImageAndText02
  • TileWide310x150ImageCollection
  • TileWide310x150PeekImage01
  • TileWide310x150PeekImage02
  • TileWide310x150PeekImage03
  • TileWide310x150PeekImage04
  • TileWide310x150PeekImage05
  • TileWide310x150PeekImage06
  • TileWide310x150PeekImageAndText01
  • TileWide310x150PeekImageAndText02
  • TileWide310x150PeekImageCollection01
  • TileWide310x150PeekImageCollection02
  • TileWide310x150PeekImageCollection03
  • TileWide310x150PeekImageCollection04
  • TileWide310x150PeekImageCollection05
  • TileWide310x150PeekImageCollection06
  • TileWide310x150SmallImageAndText01
  • TileWide310x150SmallImageAndText02
  • TileWide310x150SmallImageAndText03
  • TileWide310x150SmallImageAndText04
  • TileWide310x150SmallImageAndText05
  • TileWide310x150Text01
  • TileWide310x150Text02
  • TileWide310x150Text03
  • TileWide310x150Text04
  • TileWide310x150Text05
  • TileWide310x150Text06
  • TileWide310x150Text07
  • TileWide310x150Text08
  • TileWide310x150Text09
  • TileWide310x150Text10
  • TileWide310x150Text11

回退属性中使用的 tileTemplateNameV1 值可以是以下字符串值之一。 这些是Windows 8模板名称。 有关每个模板的详细信息，请参阅 磁贴模板目录。

  • TileSquareBlock
  • TileSquareImage
  • TileSquarePeekImageAndText01
  • TileSquarePeekImageAndText02
  • TileSquarePeekImageAndText03
  • TileSquarePeekImageAndText04
  • TileSquareText01
  • TileSquareText02
  • TileSquareText03
  • TileSquareText04
  • TileWideBlockAndText01
  • TileWideBlockAndText02
  • TileWideImage
  • TileWideImageAndText01
  • TileWideImageAndText02
  • TileWideImageCollection
  • TileWidePeekImage01
  • TileWidePeekImage02
  • TileWidePeekImage03
  • TileWidePeekImage04
  • TileWidePeekImage05
  • TileWidePeekImage06
  • TileWidePeekImageAndText01
  • TileWidePeekImageAndText02
  • TileWidePeekImageCollection01
  • TileWidePeekImageCollection02
  • TileWidePeekImageCollection03
  • TileWidePeekImageCollection04
  • TileWidePeekImageCollection05
  • TileWidePeekImageCollection06
  • TileWideSmallImageAndText01
  • TileWideSmallImageAndText02
  • TileWideSmallImageAndText03
  • TileWideSmallImageAndText04
  • TileWideSmallImageAndText05
  • TileWideText01
  • TileWideText02
  • TileWideText03
  • TileWideText04
  • TileWideText05
  • TileWideText06
  • TileWideText07
  • TileWideText08
  • TileWideText09
  • TileWideText10
  • TileWideText11

下表说明了未指定 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