ApplicationLanguages クラス

定義

名前空間:

Windows.Globalization

アプリで使用および保守できる言語関連の基本設定を指定します。

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

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

このクラスで参照される言語は、 BCP-47 言語タグで表されます。 これらはそれぞれ言語識別子であり、ロケール名ではありません。ただし、2 つの構造は同じにすることができます。 言語タグとして、"en-US" はアメリカ英語 (または米国で話される英語の方言) を意味します。 話者の実際の場所に関する主張は行いません (ただし、その多くは米国に存在します)、測定システムや通貨など、米国で使用される規則に関するその他の主張はありません。

例:

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

Note

アプリがこのクラスの言語タグを 各国語サポート 関数に渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。

言語タグは、Unicode 拡張機能 "ca-" と "nu-" をサポートしています。 (「 Unicode キー/型定義」を参照してください)。これらの拡張機能は、グローバリゼーション オブジェクトで使用される数字システムまたはカレンダーに影響を与える可能性があることに注意してください。

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) のサポートの一部です。

こちらもご覧ください

• BCP-47 言語タグに関するページ
• Unicode キー/型の定義