Language 클래스

정의

네임스페이스:

Windows.Globalization

언어 이름 및 스크립트와 같은 BCP-47 언어 태그와 관련된 정보를 제공하는 클래스입니다.

public ref class Language sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ILanguageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class Language final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ILanguageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Language

function Language(languageTag)

Public NotInheritable Class Language

상속

Object Platform::Object IInspectable Language

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

// Get the top user-preferred language and its display name.
var topUserLanguage = Windows.System.UserProfile.GlobalizationPreferences.Languages[0];
var language = new Windows.Globalization.Language(topUserLanguage);
var displayName = language.DisplayName;

설명

앱이 이 클래스에 사용된 언어 태그를 모든 국가 언어 지원 함수에 전달하는 경우 먼저 ResolveLocaleName을 호출하여 태그를 변환해야 합니다.

BCP-47 언어 태그를 사용하여 이 클래스를 초기화합니다. 예를 들어 최상의 현재 사용자 기본 설정 언어로 작업하려면 Windows.System.UserProfile.GlobalizationPreferences의 최상위 값을 전달합니다.

언어 태그는 유니코드 확장 "ca-" 및 "nu-"를 지원합니다. ( 유니코드 키/형식 정의를 참조하세요.) 이러한 확장은 Calendar 개체에서 사용하는 일정에 영향을 줄 수 있습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1803	17134	LayoutDirection
2004	19041	AbbreviatedName
2004	19041	GetMuiCompatibleLanguageListFromLanguageTags

생성자

Language(String)

Language 개체를 만듭니다.

속성

AbbreviatedName	BCP-47 언어 태그에 대한 세 글자 약어를 가져옵니다. 예를 들어 "en-US"는 "eng"로 변환됩니다.
CurrentInputMethodLanguageTag	현재 사용하도록 설정된 키보드 레이아웃 또는 IME(입력 방법 편집기)에 대한 BCP-47 언어 태그를 가져옵니다.
DisplayName	언어를 식별하기 위해 사용자에게 표시하기에 적합한 지역화된 문자열을 가져옵니다.
LanguageTag	이 언어에 대한 정규화된 BCP-47 언어 태그를 가져옵니다.
LayoutDirection	언어에 가장 적합한 콘텐츠 레이아웃 방향(텍스트 및 UI 요소의 경우)을 가져옵니다.
NativeName	언어 자체의 언어 이름을 가져옵니다.
Script	언어의 4자 ISO 15924 스크립트 코드를 가져옵니다.

메서드

GetExtensionSubtags(String)	싱글톤으로 식별된 지정된 확장의 현재 언어로 확장 하위 태그의 벡터를 검색합니다.
GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)	하나 이상의 BCP-47 언어 태그에서 파생된 MUI(다국어 사용자 인터페이스) 태그 집합을 검색합니다.
IsWellFormed(String)	BCP-47 언어 태그가 올바른 형식인지 여부를 확인합니다.
TrySetInputMethodLanguageTag(String)	이 언어의 정규화된 BCP-47 언어 태그를 설정하려고 시도합니다.

추가 정보

• OCR 샘플(Windows 10)
• 세계화 기본 설정 샘플(Windows 10)