tindakan (Toast XML Schema)

Menentukan tombol yang diperlihatkan dalam toast.

Hierarki elemen

<Roti panggang>
<Tindakan>
<Input>

Sintaks

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    afterActivationBehavior? = "default" | "pendingUpdate"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

Kunci

? opsional (nol atau satu)

Atribut dan Elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
konten Konten ditampilkan pada tombol . string Ya Tidak ada
arguments String argumen yang ditentukan aplikasi yang nantinya akan diterima aplikasi jika pengguna mengklik tombol ini. string Ya Tidak ada
jenis String argumen yang dapat diteruskan ke aplikasi terkait untuk memberikan secara spesifik tentang tindakan yang harus dijalankan sebagai respons terhadap tindakan pengguna. string Ya Tidak ada
activationType Memutuskan jenis aktivasi yang akan digunakan saat pengguna berinteraksi dengan tindakan tertentu.
  • "latar depan" - Nilai default. Aplikasi latar depan Anda diluncurkan.
  • "latar belakang" - Tugas latar belakang yang sesuai dipicu, dan Anda dapat menjalankan kode di latar belakang tanpa mengganggu pengguna.
  • "protokol" - Luncurkan aplikasi yang berbeda menggunakan aktivasi protokol.
string Tidak "latar depan"
afterActivationBehavior Menentukan perilaku yang harus digunakan toast saat pengguna mengambil tindakan pada toast.
  • "default" - Nilai default. Roti panggang akan dimatikan ketika pengguna mengambil tindakan pada toast.
  • "pendingUpdate" - Setelah pengguna mengklik tombol pada toast Anda, pemberitahuan akan tetap ada, dalam status visual "pembaruan tertunda". Anda harus segera memperbarui toast Anda dari tugas latar belakang sehingga pengguna tidak melihat status visual "pembaruan tertunda" ini terlalu lama.
string Tidak "default"
Penempatan Ketika diatur ke "contextMenu", tindakan menjadi tindakan menu konteks yang ditambahkan ke menu konteks pemberitahuan toast daripada tombol toast tradisional. string Tidak Tidak ada
imageUri URI sumber gambar untuk ikon tombol toast. Ikon ini berwarna putih transparan 16x16 piksel gambar pada penskalakan 100% dan seharusnya tidak memiliki padding yang disertakan dalam gambar itu sendiri. Jika Anda memilih untuk memberikan ikon pada pemberitahuan toast, Anda harus menyediakan ikon untuk SEMUA tombol Anda di pemberitahuan, karena mengubah gaya tombol Anda menjadi tombol ikon. Gunakan salah satu penangan protokol berikut:
  • http:// atau https:// - Gambar berbasis web.
  • ms-appx:/// - Gambar yang disertakan dalam paket aplikasi.
  • ms-appdata:///local/ - Gambar yang disimpan ke penyimpanan lokal.
  • file:/// - Gambar lokal. (Hanya didukung untuk aplikasi desktop. Protokol ini tidak dapat digunakan oleh aplikasi UWP.)
string Tidak Tidak ada
hint-inputId Atur ke Id tombol input ke posisi di samping input. string Tidak Tidak ada
hint-buttonStyle Gaya tombol. useButtonStyle harus diatur ke true dalam elemen toast .
  • "Success" - Tombol berwarna hijau
  • "Kritis" - Tombol berwarna merah.
Perhatikan bahwa nilai-nilai ini peka huruf besar/kecil.
string Tidak Tidak ada
petunjuk-toolTip Tipsalat untuk tombol, jika tombol memiliki string konten kosong. string Tidak Tidak ada

Elemen Anak

Tidak ada

Elemen Induk

Elemen Induk Deskripsi
actions Elemen kontainer untuk mendeklarasikan hingga lima input dan hingga lima tindakan tombol untuk pemberitahuan toast.

Lihat juga