FrameworkElement.Language 属性

定义

获取或设置适用于 FrameworkElement 以及对象表示形式和 UI 中当前 FrameworkElement 的所有子元素的本地化/全球化语言信息。

public:
 property Platform::String ^ Language { Platform::String ^ get(); void set(Platform::String ^ value); };
winrt::hstring Language();

void Language(winrt::hstring value);
public string Language { get; set; }
var string = frameworkElement.language;
frameworkElement.language = string;
Public Property Language As String
<frameworkElement Language="languageString" />

属性值

String

Platform::String

winrt::hstring

一个字符串,指定遵循 Internet 工程任务组 (IETF) BCP 47 标准的语言和区域性。 例如,美国英语为“en-US”。

注解

Language 属性用于在较大 UI 中的选定元素上设置每元素语言设置。 执行此操作main原因是影响与文本相关的属性和设置,例如,对于文本呈现,FontFamily 的默认或回退应该是什么。

此属性的默认值是应用语言列表中的顶级语言,该语言派生自用户的首选语言排名列表。 建议保留此属性的默认值,因为它将在字体回退方面提供最佳最终用户体验。 例如,如果应用显示东亚内容,并且用户在用户配置文件中指定了东亚语言,则内容将以所需的东亚字体显示。

Language 属性主要与以下 FrameworkElement 子类相关:

TextElement 类还具有 Language 属性,并且它对于 TextElement 子类(如 Run)具有类似的用途和行为。

如果未专门将其设置为属性,则 Language 的默认值由影响应用的全球化和本地化设置的其他较大因素决定。 这包括用户的系统设置。 有关详细信息,请参阅 全球化应用

在 UI 元素上设置语言只是为本地化和全球化准备应用所要执行的操作的一小部分。 例如,通常需要命名或加载字符串和图像等资源,并在应用包中包含这些资源。 还需要将 x:Uid 指令 值应用于应使用资源限定符获取特定于语言的资源的任何元素。 有关详细信息,请参阅 全球化应用

在标记中设置语言时,应考虑使用 RESW 资源文件指定 BCP 47 字符串,而不是在标记中对字符串进行硬编码。 在要指定 Language 的元素上指定 x:Uid 指令 值,以便资源系统可以针对该元素。 然后,提供 BCP 47 字符串的字符串资源,该资源与资源来自的资源文件夹名称匹配。 项目中可能已有一个 RESW 文件,该文件提供传统的本地化 UI 字符串。 有关详细信息,请参阅 快速入门:翻译 UI 资源

FrameworkElement.Language 和 xml:lang

XAML 是基于 XML 并遵循基本 XML 规则的语言。 这包括支持 XML 构造,例如 XML 语言 XML 命名空间中的 lang 属性。 可以在 FrameworkElement 子类的对象元素上指定 xml:lang,并且它被视为语言值一样,因为它使用字符串属性值的相同 BCP 47 处理。 还可以在不是 FrameworkElement 子类的对象元素上指定 xml:lang,但这通常不会导致该元素的任何行为更改。

语言特意使用属性继承结构,以便根元素上语言集的值会将该值传播到可视化树中的所有子对象,这些子对象也是 FrameworkElement。 这与 XML 和 XML DOM 中的 xml:lang 行为并行。 此外,可以在运行时使用 Language 读取标记中设置的 xml:lang 值,前提是从中读取的元素是具有 Language 属性的 FrameworkElement 子类。

但是,不能在同一对象元素上同时指定 Language 和 xml:lang 属性,这会引发 XAML 分析错误。

迁移说明

此 API 采用字符串。 在等效的 Microsoft Silverlight 和 Windows Presentation Foundation (WPF) API 中,此属性的类型是包装相同字符串的帮助程序对象。 可以从其他项目导入 XAML 而不注意到此差异,因为 XAML 分析字符串的方式是相同的。

适用于

另请参阅