visual (トースト XML スキーマ)

トーストを定義する 1 つの バインド 要素が含まれます。

要素の階層

<トースト>
<visual>

構文

<visual version?       = integer
        lang?          = string
        baseUri?       = anyURI
        branding?      = "none" | "logo" | "name"
        addImageQuery? = boolean >

  <!-- Child elements -->
  binding+

</visual>

キー

? 省略可能 (0 または 1) + 必須 (1 つ以上)

属性および要素

属性

属性 説明 データ型 必須 既定値
addImageQuery

Windows がトースト通知で指定されたイメージ 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:///
ブランド

使用されていません。

この属性は、次のいずれかの値になります。

  • なし
  • ロゴ
  • name
いいえ なし
ラング

XML ペイロードのターゲット ロケール。 "en-US" や "fr-FR" などの BCP-47 言語タグ として指定されます。 このロケールは、 バインディング または テキストで指定されたロケールによってオーバーライドされます。 この値がリテラル文字列の場合、この属性の既定値はユーザーの UI 言語になります。 この値が文字列リファレンスの場合、この属性の既定値は、文字列を解決する際に Windows ランタイムで選択されたロケールになります。

string いいえ なし
version

この特定のペイロードが開発されたトースト XML スキーマのバージョン。

整数 (integer) いいえ 1

 

子要素

子要素 説明
binding

トースト テンプレートを指定します。 トースト通知に含めることができるバインド要素は 1 つだけであることに注意してください。

 

親要素

Parent 要素 説明
toast

少なくとも 1 つの ビジュアル 要素を含む基本トースト要素。

こちらもご覧ください