Language クラス

リファレンス

定義

名前空間:: Windows.Globalization

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

言語名やスクリプトなど、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 言語タグの設定を試みます。

適用対象