다음을 통해 공유


ApplicationLanguages 클래스

정의

앱에서 사용하고 유지 관리할 수 있는 언어 관련 기본 설정을 지정합니다.

public ref class ApplicationLanguages abstract 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)]
class ApplicationLanguages 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)]
public static class ApplicationLanguages
Public Class ApplicationLanguages
상속
Object Platform::Object IInspectable ApplicationLanguages
특성

Windows 요구 사항

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

설명

이 클래스에서 참조되는 언어는 BCP-47 언어 태그로 표시됩니다. 이들 각각은 구조적으로 동일할 수 있지만 로캘 이름이 아닌 언어 식별자입니다. 언어 태그인 "en-US"는 미국 영어(또는 미국 영어 언어)를 의미합니다. 그것은 스피커의 실제 위치에 대한 주장을하지 않습니다 (그들 중 많은 사람들이 미국에 거주하지만) 측정 시스템이나 통화와 같은 미국에서 사용되는 규칙에 대한 다른 주장은 없습니다.

예제:

Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"

참고

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

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

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

앱이 런타임에 ApplicationLanguages 개체로 사용할 수 있는 언어는 기본 앱 패키지 매니페스트에 포함된 언어와 사용자에게 적용할 수 있는 언어 리소스 패키지에 해당하는 언어(사용자의 기본 설정에서 일치하는 언어에 따라 결정됨)로 제한되며 사용자에 대해 설치 및 등록됩니다. ApplicationLanguages.ManifestLanguages 속성은 사용자가 사용할 수 있는 언어 리소스 패키지를 반영하고 PrimaryLanguageOverride 속성을 설정하는 데 사용할 수 있는 적절한 언어 집합을 반환합니다.

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

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

버전 기록

Windows 버전 SDK 버전 추가된 값
1803 17134 GetLanguagesForUser

속성

Languages

사용자가 선호하는 현재 런타임 언어 값의 순위가 지정된 목록을 가져옵니다.

ManifestLanguages

앱에서 선언된 지원되는 언어 목록을 가져옵니다.

PrimaryLanguageOverride

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

메서드

GetLanguagesForUser(User)

지정된 사용자의 언어 기본 설정을 검색합니다. 이 API는 MUA(다중 사용자 앱)에 대한 지원의 일부입니다.

적용 대상

추가 정보