磁贴和 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 方案(例如,http
https
和ftp
)不执行任何此类自动匹配。
而是将查询字符串追加到图像的 URI 上,该字符串描述请求的限定符值或值。
<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>
然后,在提供图像的应用服务中,实现一个 HTTP 处理程序,该处理程序检查并使用查询字符串来确定要返回的图像。
还需要将 addImageQuery 属性设置为true
磁贴或 Toast 通知 XML 有效负载。 addImageQuery 属性显示在磁贴和 toast 架构的 visual
、binding
和 image
元素中。 在元素上显式设置 addImageQuery 会替代上级设置的任何值。 例如,元素中的 addImageQuery 值true
会替代其父binding
元素中的 addImageQueryfalse
。image
这些是可以使用的查询字符串。
Qualifier | 查询字符串 | 示例 |
---|---|---|
缩放 | ms-scale | ?ms-scale=400 |
语言 | ms-lang | ?ms-lang=en-US |
对比度 | ms-contrast | ?ms-contrast=high |
有关可在查询字符串中使用的所有可能的限定符值的引用表,请参阅 ResourceContext.QualifierValues。