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 つだけであることに注意してください。

こちらもご覧ください

• トーストのコンテンツ
• Notifications Visualizer