visual (タイル スキーマ)
複数の バインド 子要素が含まれており、それぞれがタイルを定義します。
要素の階層
- <tile>
- <visual>
構文
<visual version? = integer
lang? = string
baseUri? = anyURI
branding? = "none" | "logo" | "name"
addImageQuery? = boolean
contentId? = string >
<!-- Child elements -->
binding+
</visual>
キー
?
省略可能 (0 または 1) +
必須 (1 つ以上)
属性および要素
属性
属性 | 説明 | データ型 | 必須 | 既定値 |
---|---|---|---|---|
addImageQuery | タイル通知で指定されたイメージ URI にクエリ文字列を追加できるようにするには、 true に設定します。 この属性は、サーバーが画像をホストしていてクエリ文字列を処理できる場合に使用します。サーバーがこのために、クエリ文字列に基づいて画像の変化形を取得しているか、またはクエリ文字列を無視して使わずに指定の画像を返しているかどうかは問いません。 このクエリ文字列は、スケール、コントラストの設定、言語を指定します。たとえば、 の値 "www.website.com/images/hello.png" 通知に含まれる "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
boolean | いいえ | false |
Baseuri | イメージ ソース属性の相対 URI と組み合わせた既定のベース URI。 |
anyURI | いいえ | ms-appx:/// |
ブランド | アプリのブランドを表示するためにタイルで使用されるフォームです。 |
この属性は、次のいずれかの値になります。
|
いいえ | なし |
contentId | 通知の内容を一意に識別する送信者定義の文字列に設定します。 これにより、大きなタイル テンプレートで最後の 3 つのワイド タイル通知が表示される状況での重複を防ぐことができます。 |
string | いいえ | なし |
ラング | "en-US" や "fr-FR" などの BCP-47 言語タグとして指定された XML ペイロードのターゲット ロケール。 このロケールは、 バインディング または テキストで指定されたロケールによってオーバーライドされます。 この値がリテラル文字列の場合、この属性の既定値はユーザーの UI 言語になります。 この値が文字列リファレンスの場合、この属性の既定値は、文字列を解決する際に Windows ランタイムで選択されたロケールになります。 この値が指定されていない場合の備考に関するページを参照してください。 |
string | いいえ | なし |
version | この特定のペイロードが開発されたタイル XML スキーマのバージョン。 1 または 2 の 2 つの値を指定できます。 バージョン 1 には、Windows 8 スキーマの有効なペイロードが必要です。 バージョン 2 では、新しい大きなタイル テンプレート、既存のテンプレートの新しいWindows 8.1テンプレート名、およびバインド要素のフォールバック属性が認識されます。 |
整数 (integer) | いいえ | 1 |
子要素
子要素 | 説明 |
---|---|
binding | タイル テンプレートを指定します。 すべての通知には、サポートされているタイル サイズごとに 1 つのバインド要素が含まれている必要があります。 |
親要素
Parent 要素 | 説明 |
---|---|
tile | 単一の ビジュアル 要素を含む基本タイル要素。 |
注釈
次の表では、lang が指定されていない場合のシステムの応答について説明します。
For... | システム応答 |
---|---|
通知の言語 |
この言語は主に、列を特徴とするテンプレート内の列のレイアウトに影響します。 |
リテラル テキストを含むテキスト要素 |
|
ms-resource コンテンツを含むテキスト要素 |
文字列が解決されると、解決された文字列の言語がテキスト要素に割り当てられます。 この言語は、UI のテキストの配置 (LTR と RTL) とフォントの選択を調整します。 |
ms-appx:/// image |
|
クラウド イメージ |
addImageQuery が true の場合、この言語はクエリ文字列に含まれます。 |
要件
値 | |
---|---|
Namespace | http://schemas.microsoft.com/notifications/2012/tile.xsd |