次の方法で共有


ApplicationLanguages.PrimaryLanguageOverride プロパティ

定義

BCP-47 言語タグとして表される、アプリの優先言語のオーバーライドを取得または設定します。 この設定は保持されます。

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

static void PrimaryLanguageOverride(winrt::hstring value);
public static string PrimaryLanguageOverride { get; set; }
var string = ApplicationLanguages.primaryLanguageOverride;
ApplicationLanguages.primaryLanguageOverride = string;
Public Shared Property PrimaryLanguageOverride As String

プロパティ値

String

Platform::String

winrt::hstring

BCP-47 言語タグ。 アプリは、ユーザーの優先言語のランク付けされた一覧の上位言語 (ApplicationLanguages.Languages) をオーバーライドするように設定でき、その値はアプリ セッション間で保持されます。 1 つの言語タグである必要があります。言語タグの区切り記号付きリストは失敗します。

アプリが値を取得すると、PrimaryLanguageOverride は 1 つの言語タグ (アプリでプロパティを以前に設定している場合) または空の文字列を返します。

注釈

通常、アプリは、アプリでサポートされている言語とユーザーの言語設定を比較することで、システムによって決定される言語設定で実行されます。 そのシステム動作の設定は、 ApplicationLanguages.Languages プロパティを使用して取得できます。 PrimaryLanguageOverride プロパティは、特定の言語を [言語] ボックスの一覧の最初の言語として設定することで、その動作をオーバーライドするために使用されます。

PrimaryLanguageOverride 設定は、セッション間で保持されます。 アプリが読み込まれるたびに設定しないでください。 設定 UI に表示されるユーザー入力にのみ基づいて設定する必要があります。 プロパティはいつでも読み取ることができます。 プロパティが設定されていない場合は、空の文字列を返します。

PrimaryLanguageOverride を設定すると、これは ApplicationLanguages.Languages プロパティにすぐに反映されます。 ただし、この変更は、アプリ UI に読み込まれたリソースに対してすぐには有効にならない場合があります。 アプリがこのような変更に確実に応答するようにするには、既定のリソース コンテキストで QualifierValues プロパティをリッスンし、リソースを再読み込みするために必要なアクションを実行できます。 これらの要件は、アプリで使用される UI フレームワークによって異なる場合があり、アプリを再起動する必要がある場合があります。

適用対象

こちらもご覧ください