ApplicationLanguages.PrimaryLanguageOverride | primaryLanguageOverride Property

BCP 47 언어 태그로 표현된 앱 기본 언어에 대한 재정의를 가져오거나 설정합니다. 이 설정은 유지됩니다.

구문


public:
static property String^ PrimaryLanguageOverride { 
   String^ get();
   void set (String^ value);
}

속성 값

형식: String [JavaScript] | System.String [.NET] | Platform::String [C++]

BCP-47 언어 태그입니다. 앱에서 이 값을 설정하여 사용자의 기본 설정 언어 순위 목록(ApplicationLanguages.Languages)의 최상위 언어를 재정의할 수 있으며 해당 값은 앱 세션 간 유지됩니다. 단일 언어 태그여야 합니다. 구분된 언어 태그 목록은 실패합니다.

앱이 값을 가져오는 경우 PrimaryLanguageOverride는 단일 언어 태그(앱에서 이전에 속성을 설정한 경우) 또는 빈 문자열을 반환합니다.

설명

앱은 일반적으로 앱의 지원 언어와 사용자의 언어 기본 설정을 비교하여 자동 결정되는 언어 설정으로 실행됩니다. 해당 시스템 동작에 대한 설정은 ApplicationLanguages.Languages 속성을 사용하여 가져올 수 있습니다. PrimaryLanguageOverride 속성은 특정 언어를 언어 목록의 첫 번째 언어로 설정하여 해당 동작을 재정의하는 데 사용됩니다.

PrimaryLanguageOverride 설정은 세션 간에 유지됩니다. 앱이 로드될 때마다 설정하면 안 됩니다. 설정 UI에 제공된 사용자 설정에 따라 설정해야 합니다. 이 속성은 언제든지 읽을 수 있습니다. 속성이 설정되지 않은 경우 빈 문자열을 반환합니다.

PrimaryLanguageOverride를 설정하면 즉시 ApplicationLanguages.Languages 속성에 반영됩니다. 그러나 이 변경 내용은 앱 UI에 로드된 리소스에서 즉시 적용되지 않을 수도 있습니다. 앱이 이러한 변경에 응답하도록 하기 위해 기본 리소스 컨텍스트의 QualifierValues 속성을 수신 대기하고 리소스를 다시 로드하는 데 필요한 작업을 수행할 수 있습니다. 이러한 요구 사항은 앱에서 사용하는 UI 프레임워크에 따라 달라질 수 있으며, 앱을 다시 시작해야 할 수도 있습니다.

참고  앱은 이 클래스에서 National Language Support 함수로 언어 태그를 전달하는 경우 먼저 ResolveLocaleName을 호출하여 태그를 변환해야 합니다.

Windows 8.1부터:

언어 태그는 유니코드 확장을 지원할 수 있습니다. ApplicationLanguages 클래스에 대한 자세한 내용은 설명 부분을 참조하십시오.

Windows 스토어 앱은 리소스 패키지를 사용하여 배포할 수 있습니다. 언어 리소스 패키지를 사용하는 경우 지정된 사용자에 대해 설치 및 등록되는 패키지는 사용자 언어 프로필의 언어에 따라 결정됩니다. 결과적으로 Windows 스토어에 제출된 앱 번들에 포함된 모든 언어를 런타임 시 사용할 수 있어야 하는 것은 아닙니다. PrimaryLanguageOverride 속성은 사용자가 사용할 수 있는 언어로만 설정해야 합니다.

앱이 런타임에 ApplicationLanguages 개체로 사용할 수 있는 언어는 기본 앱 패키지 매니페스트 및 사용자에게 적용되는 언어 리소스 패키지에 해당하는 언어(사용자 기본 설정의 언어와 비교하여 결정됨)로 제한됩니다. ApplicationLanguages.ManifestLanguages 속성은 사용자에게 제공되는 언어 리소스 팩을 반영하므로 PrimaryLanguageOverride 속성을 설정하는 데 사용할 수 있는 적절한 언어 집합을 반환합니다.

ApplicationLanguages.Languages 속성은 매우 비슷한 목록을 ManifestLanguages 속성에 반환합니다. 하지만 패키지 매니페스트에 나열되지 않은 지역 언어 변형을 포함한다는 것이 다를 수 있습니다. 예를 들어 사용자의 프로필에 "en-CA"가 포함되어 있고 응용 프로그램에서 영어의 지역적 변형이 지원되는 경우 Languages 속성에 의해 "en-CA"(영어(캐나다))가 반환될 수 있습니다. 앱에서 사용자에게 적합한 세계화 동작을 제공할 수 있도록 사용자 파생 지역 언어 변형을 사용하여 PrimaryLanguageOverride 속성을 설정하는 것이 더 좋을 수 있습니다.

언어가 기본 앱 패키지에 있지만 사용자의 기본 설정에 있는 언어와 일치하지 않을 경우 ManifestLanguages 속성에 의해서는 반환되지만 Languages 속성에 의해서는 반환되지 않습니다. 이는 PrimaryLanguageOverride 속성을 설정하는 데에도 사용할 수 있습니다. 그러나 이러한 언어는 사용자의 기본 설정에 반영되지 않으므로 사용자가 해당 언어를 이해하지 못할 수 있습니다. 이러한 설정은 사용자가 직접 선택하는 경우에만 사용해야 합니다.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

Namespace

Windows.Globalization
Windows::Globalization [C++]

Metadata

Windows.winmd

참고 항목

ApplicationLanguages
ApplicationLanguages.Languages
BCP-47 언어 태그

 

 

표시:
© 2014 Microsoft