次の方法で共有

言語、スケール、ハイ コントラストに合わせたタイルとトースト通知のサポート

  • [アーティクル]

タイルとトーストは、表示言語、 表示スケール ファクター、、ハイ コントラスト、その他のランタイム コンテキストに合わせて調整された文字列と画像を読み込むことができます。 リソース ファイルの名前に修飾子を使用する方法の詳細については、「言語、スケール、その他の修飾子用にリソースを調整する」と「アプリのアイコンとロゴ」をご覧ください。

アプリのローカライズの価値提案の詳細については、「グローバリゼーションとローカライズ」 を参照してください。

テンプレートから文字列リソースを参照する

タイルまたはトースト テンプレートでは、 ms-resource URI (Uniform Resource Identifier) スキームの後に単純な文字列リソース識別子を使用して、文字列リソースを参照できます。 たとえば、"Farewell" という名前のリソース エントリを含む Resources.resx ファイルがある場合は、識別子 "Farewell" を持つ文字列リソースがあります。 文字列リソース識別子とリソース ファイル (.resw) の詳細については、「 UI およびアプリ パッケージ マニフェストで文字列をローカライズするを参照してください。

これは、"Farewell" 文字列リソース識別子への参照が、テンプレート コンテンツの テキスト 本文で ms-resourceを使用してどのように表示されるかを示します。

<text id="1">ms-resource:Farewell</text>

ms-resource URI スキームを省略した場合、テキスト本文は単なる文字列リテラルであり、識別子への参照。

<text id="1">Farewell</text>

テンプレートからイメージ リソースを参照する

タイルまたはトースト テンプレートでは、 ms-appx URI (Uniform Resource Identifier) スキームの後にイメージ リソースの名前を付けて、イメージ リソースを参照できます。 これは、XAML マークアップでイメージ リソースを参照するのと同じ方法です (詳細については、「 XAML マークアップとコードからイメージまたはその他の資産を参照するを参照してください)。

たとえば、次のようにフォルダーに名前を付けます。

\Assets\Images\contrast-standard\welcome.png
\Assets\Images\contrast-high\welcome.png

その場合は、イメージ リソースが 1 つあり、その名前 (絶対パスとして) が /Assets/Images/welcome.png。 テンプレートでその名前を使用する方法を次に示します。

<image id="1" src="ms-appx:///Assets/Images/welcome.png"/>

この例の URI では、スキーム ("ms-appx") の後に "://" が続き、その後に絶対パスが続きます (絶対パスは "/" で始まります)。

クラウドでのイメージのホスティングと読み込み

ms-resourceおよびms-appx URI スキームは、自動修飾子照合を実行して、現在のコンテキストに最も適したリソースを見つけます。 Web URI スキーム ( http、 https、 ftpなど) では、このような自動照合は実行されません。

代わりに、要求された修飾子の値を記述するクエリ文字列をイメージの URI に追加します。

<image id="1" src="http://www.contoso.com/Assets/Images/welcome.png?ms-lang=en-US"/>

次に、イメージを提供するアプリ サービスで、クエリ文字列を検査して使用して返す画像を決定する HTTP ハンドラーを実装します。

また、addImageQuery 属性を tile または toast 通知 XML ペイロードにtrueするように設定する必要があります。 addImageQuery 属性は、タイル スキーマとトースト スキーマの両方のvisual、binding、およびimage要素に表示されます。 要素 addImageQuery を明示的に設定すると、先祖に設定されたすべての値がオーバーライドされます。 たとえば、image要素のtrueのaddImageQuery値は、親binding要素のfalseのaddImageQueryをオーバーライドします。

これらは、使用できるクエリ文字列です。

修飾子 クエリ文字列 例
スケール ms-scale ?ms-scale=400
Language ms-lang ?ms-lang=en-US
コントラスト ms-contrast ?ms-contrast=high

クエリ文字列で使用できるすべての修飾子値の参照テーブルについては、「 ResourceContext.QualifierValuesを参照してください。

重要な API