言語、スケール、ハイ コントラストに合わせたタイルとトースト通知のサポート
Note
Lives タイルは、新しいバージョンの Windows ではサポートされていない Windows 10 の機能です。 新しいアプリの場合は、 App アイコンの現在のガイダンスに従うことをお勧めします。
タイルとトーストは、表示言語、 表示スケール ファクター、、ハイ コントラスト、その他のランタイム コンテキストに合わせて調整された文字列と画像を読み込むことができます。 リソース ファイルの名前で修飾子を使用する方法の背景については、「 言語、スケール、およびその他の修飾子についてリソースを調整する および App アイコンを参照してください。
アプリのローカライズの価値提案の詳細については、「グローバリゼーションとローカライズ」 を参照してください。
テンプレートから文字列リソースを参照する
タイルまたはトースト テンプレートでは、 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を参照してください。