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,尽管这通常不会导致该元素的任何行为更改。

语言特意使用属性继承结构,以便根元素上设置的 Language 值会将该值传播到可视化树中也是 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 分析字符串的方式是相同的。

适用于

另请参阅