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

  • [アーティクル]

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

要素の階層

<トースト>
<visual>
<binding>
<イメージ>

構文

<image id             = integer
       src            = string
       alt?           = string
       addImageQuery? = boolean 
       placement? = "appLogoOverride" | "hero"
       hint-crop? = "circle" />

キー

? 省略可能 (0 または 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
alt

支援技術のユーザー向けの画像の説明。

 string いいえ なし
id

このイメージが意図されているトースト テンプレート内の image 要素。 テンプレートにイメージが 1 つしかない場合、この値は 1 です。 使用可能なイメージ位置の数は、テンプレート定義に基づいています。

 整数 (integer) はい なし
src

イメージ ソースの URI。次のいずれかのプロトコル ハンドラーを使用します。

  • http:// または https://

    Web ベースのイメージ。

  • ms-appx:///

    アプリ パッケージに含まれるイメージ。

  • ms-appdata:///local/

    ローカル ストレージに保存されたイメージ。

  • ファイル：///

    ローカル イメージ。 (デスクトップ アプリでのみサポートされます。このプロトコルは、UWP アプリでは使用できません)。)

 string はい なし
placement

イメージの配置。

  • "appLogoOverride" - イメージは、トースト通知でアプリのロゴを置き換えます。
  • "hero" - 画像がヒーローイメージとして表示されます。

詳細については、「 トースト コンテンツ」を参照してください。

 string いいえ なし
hint-crop

イメージのトリミング。

  • "circle" - 画像は円にトリミングされます。
  • 未指定 - 画像はトリミングされず、正方形として表示されます。

詳細については、「 トースト コンテンツ」を参照してください。

 string いいえ なし

 

子要素

なし。

親要素

Parent 要素 説明
binding

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

こちらもご覧ください