磁贴和 toast 通知的语言、比例和高对比度支持

注意

生活磁贴是 Windows 10 功能,在更高版本的 Windows 上不受支持。 对于新应用,建议遵循应用图标的当前指南

磁贴和 Toast 可以加载为显示语言、显示比例系数高对比度和其他运行时上下文定制的字符串和图像。 有关如何在资源文件名称中使用限定符的背景信息,请参阅 针对语言、缩放和其他限定符和其他限定符应用图标定制资源。

有关对应用进行本地化的价值主张的详细信息,请参阅全球化和本地化

从模板引用字符串资源

在磁贴或 Toast 模板中,可以使用 URI(统一资源标识符)方案引用字符串资源 ms-resource ,后跟简单的字符串资源标识符。 例如,如果你有一个 Resources.resx 文件,其中包含一个名称为“Farewell”的资源条目,则你有一个标识符为“Farewell”的字符串资源。 有关字符串资源标识符和资源文件(.resw)的详细信息,请参阅 UI 和应用包清单中的本地化字符串。

这是对“Farewell”字符串资源标识符的引用在模板内容的文本正文中,使用ms-resource的方式。

<text id="1">ms-resource:Farewell</text>

如果省略 ms-resource URI 方案,则文本正文只是字符串文本, 而不是 对标识符的引用。

<text id="1">Farewell</text>

从模板引用图像资源

在磁贴或 Toast 模板中,可以使用 URI(统一资源标识符)方案引用图像资源 ms-appx ,后跟图像资源的名称。 这与在 XAML 标记中引用图像资源的方式相同(有关更多详细信息,请参阅 从 XAML 标记和代码引用图像或其他资产)。

例如,可以命名如下所示的文件夹。

\Assets\Images\contrast-standard\welcome.png
\Assets\Images\contrast-high\welcome.png

在这种情况下,你有一个映像资源及其名称(作为绝对路径)。/Assets/Images/welcome.png 下面介绍了如何在模板中使用该名称。

<image id="1" src="ms-appx:///Assets/Images/welcome.png"/>

请注意此示例 URI 中的方案(“”)后跟“://”,ms-appx后跟绝对路径(绝对路径以“/” 开头)。

在云中托管和加载图像

URI ms-resource ms-appx 方案执行自动限定符匹配,以查找最适合当前上下文的资源。 Web URI 方案(例如,httphttpsftp)不执行任何此类自动匹配。

而是将查询字符串追加到图像的 URI 上,该字符串描述请求的限定符值或值。

<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>

然后,在提供图像的应用服务中,实现一个 HTTP 处理程序,该处理程序检查并使用查询字符串来确定要返回的图像。

还需要将 addImageQuery 属性设置为true磁贴Toast 通知 XML 有效负载。 addImageQuery 属性显示在磁贴和 toast 架构的 visualbindingimage 元素中。 在元素上显式设置 addImageQuery 会替代上级设置的任何值。 例如,元素中的 addImageQuerytrue会替代其父binding元素中的 addImageQueryfalseimage

这些是可以使用的查询字符串。

Qualifier 查询字符串 示例
缩放 ms-scale ?ms-scale=400
语言 ms-lang ?ms-lang=en-US
对比度 ms-contrast ?ms-contrast=high

有关可在查询字符串中使用的所有可能的限定符值的引用表,请参阅 ResourceContext.QualifierValues

重要的 API