磁贴和 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
的 true
addImageQuery 值将替代其父binding
元素中的 addImageQueryfalse
。
以下是你可以使用的查询字符串。
限定符 | 查询字符串 | 示例 |
---|---|---|
缩放 | ms-scale | ?ms-scale=400 |
语言 | ms-lang | ?ms-lang=en-US |
与此示例 | ms-contrast | ?ms-contrast=high |
有关你在查询字符串中可以使用的所有可能的限定符值的参考表,请参阅 ResourceContext.QualifierValues。
重要的 API
相关主题
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈