toast (Toast XML Schema)

  • Artikel

Elemen toast dasar, yang berisi setidaknya satu elemen visual .

Hierarki elemen

<Roti panggang>

Sintaks

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

Kunci

? opsional (nol atau satu)

Atribut dan Elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
durasi

Jumlah waktu toast harus ditampilkan.

Atribut ini dapat memiliki salah satu nilai berikut:

  • long
  • short
 Tidak Tidak ada
Peluncuran

String yang diteruskan ke aplikasi saat diaktifkan oleh toast. Format dan konten string ini ditentukan oleh aplikasi untuk penggunaannya sendiri. Saat pengguna mengetuk atau mengeklik toast untuk meluncurkan aplikasi terkait, string peluncuran menyediakan konteks ke aplikasi yang memungkinkannya menampilkan tampilan yang relevan dengan konten toast kepada pengguna, daripada meluncurkan dengan cara defaultnya.

 string Tidak Tidak ada
displayTimestamp

Diperkenalkan dalam Pembaruan Pembuat: Mengambil alih tanda waktu default dengan tanda waktu kustom yang mewakili kapan konten pemberitahuan Anda benar-benar dikirimkan, bukan waktu pemberitahuan diterima oleh platform Windows. Nilai ini harus berupa string yang diformat menggunakan standar ISO 8601.

 string Tidak Tidak ada
Skenario

Skenario yang digunakan untuk toast Anda, seperti alarm atau pengingat.

  • "pengingat" - Pemberitahuan pengingat. Ini akan ditampilkan sebelum diperluas dan tetap berada di layar pengguna sampai diberhentikan. Perhatikan bahwa ini akan diabaikan secara diam-diam kecuali ada tindakan tombol toast yang diaktifkan di latar belakang.
  • "alarm" - Pemberitahuan alarm. Ini akan ditampilkan sebelum diperluas dan tetap berada di layar pengguna sampai diberhentikan. Audio akan diulang secara default dan akan menggunakan audio alarm.
  • "incomingCall" - Pemberitahuan panggilan masuk. Ini akan ditampilkan sebelum diperluas dalam format panggilan khusus dan tetap berada di layar pengguna sampai diberhentikan. Audio akan diulang secara default dan akan menggunakan audio nada dering.
  • "mendesak" - Pemberitahuan penting. Hal ini memungkinkan pengguna untuk memiliki kontrol lebih besar atas aplikasi apa yang dapat mengirimi mereka pemberitahuan toast berprioritas tinggi yang dapat menerobos Bantuan Fokus (Jangan Ganggu). Ini dapat dimodifikasi dalam pengaturan pemberitahuan.

 string Tidak Tidak ada
useButtonStyle

Menentukan apakah tombol bertata harus digunakan. Gaya tombol ditentukan oleh atribut **hint-buttonStyle** dari elemen tindakan .

 boolean Tidak salah

 

Elemen Anak

Elemen Anak Deskripsi
Audio

Menentukan suara yang akan diputar ketika pemberitahuan toast ditampilkan. Elemen ini juga memungkinkan Anda untuk membisukan audio pemberitahuan toast apa pun.
perintah

Menentukan bahwa pemberitahuan toast sedang digunakan untuk menunjukkan panggilan masuk atau alarm, dengan perintah yang sesuai yang terkait dengan setiap skenario.
Visual

Berisi satu elemen pengikatan yang mendefinisikan toast.
actions

Elemen kontainer untuk mendeklarasikan hingga lima input dan hingga lima tindakan tombol untuk pemberitahuan toast.
header

Diperkenalkan dalam Pembaruan Kreator. Menentukan header kustom yang mengelompokkan beberapa pemberitahuan bersama-sama dalam Pusat Tindakan.

 

Elemen Induk

Elemen terluar (dokumen) ini mungkin tidak dimuat oleh elemen lain.

Lihat juga