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

  • 项目

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

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

从模板引用字符串资源

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

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

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

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

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

引用模板中的图像资源

在你的磁贴或 toast 模板中，你可以使用后跟图像资源名称的 ms-appx URI（统一资源标识符）方案来引用图像资源。 方法与你引用 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”）后依次跟随“://”和绝对路径（以“/”开头的绝对路径）。

在云中托管和加载图像

ms-resource 和 ms-appx URI 方案执行自动限定符匹配，以查找最适合当前上下文的资源。 Web URI 方案（如 http、https 和 ftp）无法执行任何此类自动匹配。

改为在你的图像的 URI 上附加一个描述请求的限定符值的查询字符串。

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

然后，在提供图像的应用服务中，实施检查和使用查询字符串确定要返回的图像的 HTTP 处理程序。

你还需在磁贴或 toast 通知 XML 负载中将 addImageQuery 属性设置为 true。 addImageQuery 属性显示在磁贴和 toast 架构的 visual、binding 和 image 元素中。 在元素上显式设置 addImageQuery 将覆盖在上级元素上设置的任何值。 例如，元素中 image 的 trueaddImageQuery 值将替代其父binding元素中的 addImageQueryfalse。

以下是你可以使用的查询字符串。

限定符 查询字符串 示例
缩放 ms-scale ?ms-scale=400
语言 ms-lang ?ms-lang=en-US
与此示例 ms-contrast ?ms-contrast=high

有关你在查询字符串中可以使用的所有可能的限定符值的参考表，请参阅 ResourceContext.QualifierValues。

重要的 API