Language クラス

  • リファレンス

定義

名前空間:
Windows.Globalization
編集

言語名やスクリプトなど 、BCP-47 言語タグに関連する情報を提供するクラス。

public ref class Language sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ILanguageFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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 Language final
/// [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.Activatable(typeof(Windows.Globalization.ILanguageFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 sealed class Language
[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 から最上位の値を渡します。

言語タグは、Unicode 拡張機能 "ca-" と "nu-" をサポートしています。 ( 「Unicode キー/型定義」を参照してください)。これらの拡張機能は、Calendar オブジェクトで使用される予定表に影響を与える可能性があることに注意してください。

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1803 17134 LayoutDirection
2004 19041 AbbreviatedName
2004 19041 GetMuiCompatibleLanguageListFromLanguageTags

コンストラクター

Language(String)

Language オブジェクトを作成します。

プロパティ

AbbreviatedName

BCP-47 言語タグの 3 文字の省略形を取得します。 たとえば、"en-US" は "eng" に変換されます。
CurrentInputMethodLanguageTag

現在有効になっているキーボード レイアウトまたは入力メソッド エディター (IME) の BCP-47 言語タグを取得します。
DisplayName

言語を識別するためにユーザーに表示するのに適したローカライズされた文字列を取得します。
LanguageTag

この言語の正規化された BCP-47 言語タグを取得します。
LayoutDirection

言語に最も適したコンテンツ レイアウトの方向 (テキスト要素と UI 要素の場合) を取得します。
NativeName

言語自体の言語の名前を取得します。
Script

言語の 4 文字の ISO 15924 スクリプト コードを取得します。

メソッド

GetExtensionSubtags(String)

シングルトンで識別される特定の拡張機能の現在の言語の拡張サブタグのベクターを取得します。
GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)

1 つ以上の BCP-47 言語タグから派生した多言語 ユーザー インターフェイス (MUI) タグのセットを取得します。
IsWellFormed(String)

BCP-47 言語タグが整形式であるかどうかを判断します。
TrySetInputMethodLanguageTag(String)

この言語の正規化された BCP-47 言語タグの設定を試みます。

適用対象

こちらもご覧ください