gambar (Skema XML Toast)

Menentukan gambar yang digunakan dalam templat toast.

Hierarki elemen

<Roti panggang>
<Visual>
<pengikatan>
<Gambar>

Sintaks

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

Kunci

? opsional (nol atau satu)

Atribut dan Elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
addImageQuery

Atur ke "true" untuk memungkinkan Windows menambahkan string kueri ke URI gambar yang disediakan dalam pemberitahuan toast. Gunakan atribut ini jika server Anda menghosting gambar dan dapat menangani string kueri, baik dengan mengambil varian gambar berdasarkan string kueri atau dengan mengabaikan string kueri dan mengembalikan gambar seperti yang ditentukan tanpa string kueri. String kueri ini menentukan skala, pengaturan kontras, dan bahasa; misalnya, nilai

"www.website.com/images/hello.png"

diberikan dalam pemberitahuan menjadi

"www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

boolean Tidak salah
Alt

Deskripsi gambar, untuk pengguna teknologi bantuan.

string Tidak Tidak ada
id

Elemen gambar dalam templat toast yang dimaksudkan gambar ini. Jika templat hanya memiliki satu gambar, maka nilai ini adalah 1. Jumlah posisi gambar yang tersedia didasarkan pada definisi templat.

bilangan bulat Ya Tidak ada
src

URI sumber gambar, menggunakan salah satu penangan protokol ini:

  • http:// atau https://

    Gambar berbasis web.

  • ms-appx:///

    Gambar yang disertakan dalam paket aplikasi.

  • ms-appdata:///local/

    Gambar disimpan ke penyimpanan lokal.

  • File:///

    Gambar lokal. (Hanya didukung untuk aplikasi desktop. Protokol ini tidak dapat digunakan oleh aplikasi UWP.)

string Ya Tidak ada
Penempatan

Penempatan gambar.

  • "appLogoOverride" - Gambar menggantikan logo aplikasi Anda di pemberitahuan toast.
  • "hero" - Gambar ditampilkan sebagai gambar hero.

Untuk informasi selengkapnya, lihat Konten toast.

string Tidak Tidak ada
hint-crop

Pemangkasan gambar.

  • "lingkaran" - Gambar dipangkas menjadi lingkaran.
  • Tidak ditentukan - Gambar tidak dipangkas dan ditampilkan sebagai persegi.

Untuk informasi selengkapnya, lihat Konten toast.

string Tidak Tidak ada

 

Elemen Anak

Tidak ada.

Elemen Induk

Elemen Induk Deskripsi
Azure Storage

Menentukan templat toast. Perhatikan bahwa hanya satu elemen pengikatan yang dapat disertakan dalam pemberitahuan toast.

Lihat juga