Bagikan melalui

Header toast

  • Artikel

Anda dapat mengelompokkan sekumpulan pemberitahuan terkait secara visual di dalam Pusat Tindakan dengan menggunakan header toast pada pemberitahuan Anda.

Penting

Memerlukan Pembaruan Pembuat Desktop dan pustaka Pemberitahuan 1.4.0: Anda harus menjalankan Desktop build 15063 atau yang lebih baru untuk melihat header toast. Anda harus menggunakan versi 1.4.0 atau yang lebih baru dari pustaka NuGet Pemberitahuan Toolkit Komunitas UWP untuk membuat header di konten roti panggang Anda. Header hanya didukung di Desktop.

Seperti yang terlihat di bawah ini, percakapan grup ini disatukan di bawah header tunggal, "Camping!!". Setiap pesan individu dalam percakapan adalah pemberitahuan toast terpisah yang berbagi header toast yang sama.

Roti panggang dengan header

Anda juga dapat memilih untuk mengelompokkan pemberitahuan anda secara visual berdasarkan kategori juga, seperti pengingat penerbangan, pelacakan paket, dan banyak lagi.

Menambahkan header ke toast

Berikut cara Anda menambahkan header ke pemberitahuan toast.

Catatan

Header hanya didukung di Desktop. Perangkat yang tidak mendukung header hanya akan mengabaikan header.

new ToastContentBuilder()
    .AddHeader("6289", "Camping!!", "action=openConversation&id=6289")
    .AddText("Anyone have a sleeping bag I can borrow?");

Singkatnya...

  1. Menambahkan Header ke ToastContent Anda
  2. Menetapkan properti Id, Judul, dan Argumen yang diperlukan
  3. Kirim pemberitahuan Anda (pelajari lebih lanjut)
  4. Pada pemberitahuan lain, gunakan ID header yang sama untuk menyatukannya di bawah header. Id adalah satu-satunya properti yang digunakan untuk menentukan apakah pemberitahuan harus dikelompokkan, yang berarti Judul dan Argumen bisa berbeda. Judul dan Argumen dari pemberitahuan terbaru dalam grup digunakan. Jika pemberitahuan tersebut dihapus, maka Judul dan Argumen akan kembali ke pemberitahuan terbaru berikutnya.

Menangani aktivasi dari header

Header dapat diklik oleh pengguna, sehingga pengguna dapat mengklik header untuk mengetahui lebih lanjut dari aplikasi Anda.

Oleh karena itu, aplikasi dapat menyediakan Argumen di header, mirip dengan argumen peluncuran pada toast itu sendiri.

Aktivasi ditangani identik dengan aktivasi roti panggang normal, yang berarti Anda dapat mengambil argumen ini dalam metode App.xaml.cs OnActivated seperti yang Anda lakukan ketika pengguna mengklik isi roti panggang Anda atau tombol di roti panggang Anda.

protected override void OnActivated(IActivatedEventArgs e)
{
    // Handle toast activation
    if (e is ToastNotificationActivatedEventArgs)
    {
        // Arguments specified from the header
        string arguments = (e as ToastNotificationActivatedEventArgs).Argument;
    }
}

Info tambahan

Header secara visual memisahkan dan mengelompokkan pemberitahuan. Ini tidak mengubah logistik lain tentang jumlah maksimum pemberitahuan yang dapat dimiliki aplikasi (20) dan perilaku pertama kali keluar dari daftar pemberitahuan.

Urutan pemberitahuan dalam header adalah sebagai berikut... Untuk aplikasi tertentu, pemberitahuan terbaru dari aplikasi (dan seluruh grup header jika bagian dari header) akan muncul terlebih dahulu.

Id dapat berupa string apa pun yang Anda pilih. Tidak ada batasan panjang atau karakter pada salah satu properti di ToastHeader. Satu-satunya batasan adalah bahwa seluruh konten roti panggang XML Anda tidak boleh lebih besar dari 5 KB.

Membuat header tidak mengubah jumlah pemberitahuan yang ditampilkan di dalam Pusat Tindakan sebelum tombol "Lihat selengkapnya" muncul (angka ini adalah 3 secara default dan dapat dikonfigurasi oleh pengguna untuk setiap aplikasi di Pengaturan sistem untuk pemberitahuan).

Mengklik header, sama seperti mengklik judul aplikasi, tidak menghapus pemberitahuan apa pun milik header ini (aplikasi Anda harus menggunakan API toast untuk menghapus pemberitahuan yang relevan).