Header pemberitahuan aplikasi

Anda dapat mengelompokkan sekumpulan pemberitahuan terkait secara visual di Pusat Pemberitahuan dengan menambahkan header ke pemberitahuan Anda.

Dalam contoh yang ditunjukkan di bawah ini, percakapan grup ini disatukan di bawah header tunggal, "Camping!!". Setiap pesan individual dalam percakapan adalah pemberitahuan aplikasi terpisah yang berbagi header yang sama.

Pemberitahuan dengan header

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

Untuk informasi selengkapnya tentang pemberitahuan aplikasi, lihat Ringkasan pemberitahuan aplikasi.

Menambahkan header ke pemberitahuan

Nota

AppNotificationBuilder saat ini tidak menyertakan SetHeader metode, jadi gunakan payload XML langsung dengan konstruktor AppNotification .

using Microsoft.Windows.AppNotifications;

string xml = @"
<toast>
    <header id='6289' title='Camping!!' arguments='action=openConversation&amp;id=6289'/>
    <visual>
        <binding template='ToastGeneric'>
            <text>Anyone have a sleeping bag I can borrow?</text>
        </binding>
    </visual>
</toast>";

var notification = new AppNotification(xml);
AppNotificationManager.Default.Show(notification);

Untuk mengelompokkan beberapa pemberitahuan di bawah header yang sama, gunakan Id header yang sama pada setiap pemberitahuan. Id adalah satu-satunya properti yang digunakan untuk menentukan pengelompokan — Judul dan Argumen dapat berbeda di antara pemberitahuan. Nilai dari notifikasi terbaru dalam grup ini ditampilkan. Jika pemberitahuan tersebut dihapus, nilai akan kembali ke pemberitahuan terbaru berikutnya.

Menangani aktivasi dari header

Header dapat diklik. Properti Argumen pada header menentukan konteks apa yang akan diteruskan ke aplikasi Anda saat pengguna mengklik header, mirip dengan meluncurkan argumen pada pemberitahuan itu sendiri.

Aktivasi dari header ditangani melalui peristiwa NotificationInvoked , sama seperti aktivasi pemberitahuan lainnya. Untuk informasi selengkapnya tentang menyiapkan aktivasi, lihat Pemberitahuan aplikasi Mulai cepat.

AppNotificationManager.Default.NotificationInvoked += (sender, args) =>
{
    // For the header defined above, args.Argument contains:
    // "action=openConversation&id=6289"
    string arguments = args.Argument;
};

Rincian tambahan

  • Header secara visual memisahkan dan mengelompokkan pemberitahuan tetapi tidak mengubah jumlah maksimum pemberitahuan yang dapat dimiliki aplikasi (20) atau perilaku pertama kali keluar dari daftar pemberitahuan.
  • Id dapat berupa string apa pun. Tidak ada batasan panjang atau karakter pada properti header. Satu-satunya batasan adalah bahwa seluruh konten pemberitahuan XML tidak boleh melebihi 5 KB.
  • Membuat header tidak mengubah jumlah pemberitahuan yang ditampilkan di Pusat Pemberitahuan sebelum tombol "Lihat selengkapnya" muncul (3 secara default, dapat dikonfigurasi oleh pengguna di pengaturan pemberitahuan sistem).
  • Mengklik header tidak menghapus pemberitahuan milik header tersebut. Aplikasi Anda harus menggunakan API pemberitahuan untuk menghapus pemberitahuan yang relevan.

Baca juga

  • Last updated on