binding (Toast XML スキーマ)

  • [アーティクル]

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

要素の階層

<トースト>
<visual>
<binding>

構文

<binding template       = "ToastGeneric"
         fallback?      = string
         lang?          = string
         addImageQuery? = boolean
         baseUri?       = anyURI
         branding?      = string >

  <!-- Child elements -->
  ( image
  | text
  | group
  | progress
  )*

</binding>

キー

? 省略可能 (0 または 1) * 省略可能 (0 以上)

属性および要素

属性

属性 説明 データ型 必須 既定値
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
 いいえ なし
fallback

下位互換性で使用するために、プライマリ テンプレートが見つからない場合に使用するテンプレート。

 string いいえ なし
ラング

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

 string いいえ なし
template

この値は "ToastGeneric" に設定する必要があります

 string はい なし

 

子要素

子要素 説明
image

トースト テンプレートで使用されるイメージを指定します。
text

トースト テンプレートで使用されるテキストを指定します。
group

グループ内のコンテンツを全体として表示するか、または収まらない場合は表示しない必要があることを意味的に識別します。 複数の列を作成することも可能にします。
progress

トースト テンプレートで使用されるテキストを指定します。

 

親要素

Parent 要素 説明
Visual

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

 

こちらもご覧ください