Pita kemajuan pemberitahuan aplikasi dan pengikatan data

Menggunakan bilah kemajuan di dalam pemberitahuan aplikasi memungkinkan Anda untuk menyampaikan status operasi jangka panjang kepada pengguna, seperti unduhan, penyajian video, tujuan latihan, dan banyak lagi.

Bilah kemajuan di dalam pemberitahuan aplikasi dapat "tidak ditentukan" (tidak ada nilai tertentu, titik animasi menunjukkan operasi sedang terjadi) atau "menentukan" (persentase tertentu dari bilah diisi, seperti 60%).

Gambar di bawah ini menunjukkan bilah kemajuan tertentu dengan semua properti sesuai berlabel.

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

Harta benda	Tipe	Required	Deskripsi
Title	teks atau BindableString	salah	Mendapatkan atau menetapkan string judul opsional. Mendukung pengikatan data.
Nilai	double atau AdaptiveProgressBarValue atau BindableProgressBarValue	salah	Mendapatkan atau mengatur nilai bilah kemajuan. Mendukung pengikatan data. Disetel ke 0. Dapat berupa ganda antara 0,0 dan 1,0, AdaptiveProgressBarValue.Indeterminate, atau new BindableProgressBarValue("myProgressValue").
ValueStringOverride	teks atau BindableString	salah	Mendapatkan atau mengatur string opsional yang akan ditampilkan alih-alih string persentase default. Jika ini tidak disediakan, sesuatu seperti "70%" akan ditampilkan.
Status	teks atau BindableString	benar	Mengambil atau menetapkan string status (diperlukan), yang ditampilkan di bawah bilah kemajuan sebelah kiri. String ini harus mencerminkan status operasi, seperti "Mengunduh..." atau "Menginstal..."

Gunakan AppNotificationBuilder.AddProgressBar untuk menambahkan bilah kemajuan ke pemberitahuan Anda. Contoh berikut menghasilkan pemberitahuan yang ditunjukkan di atas.

var builder = new AppNotificationBuilder()
    .AddText("Downloading your weekly playlist...")
    .AddProgressBar(new AppNotificationProgressBar()
        .SetTitle("Weekly playlist")
        .SetValue(0.6)
        .SetValueStringOverride("15/26 songs")
        .SetStatus("Downloading..."));

Untuk memperbarui nilai bilah kemajuan secara dinamis, gunakan pengikatan data seperti yang dijelaskan di bagian berikutnya.

Memperbarui bilah kemajuan dengan pengikatan data

Untuk menampilkan bilah kemajuan langsung, gunakan pengikatan data untuk memperbarui nilai pemberitahuan tanpa mengirim ulang seluruh pemberitahuan.

1. Buat konten pemberitahuan dengan bidang terikat data dengan memanggil Bind metode di AppNotificationProgressBar.
2. Tetapkan Tag (dan secara opsional Grup) untuk mengidentifikasi pemberitahuan.
3. Atur nilai AppNotificationProgressData awal.
4. Tampilkan pemberitahuan dengan memanggil AppNotificationManager.Default.Show.

using Microsoft.Windows.AppNotifications;
using Microsoft.Windows.AppNotifications.Builder;

string tag = "weekly-playlist";
string group = "downloads";

var builder = new AppNotificationBuilder()
    .AddText("Downloading your weekly playlist...")
    .AddProgressBar(new AppNotificationProgressBar()
        .BindTitle()
        .BindValue()
        .BindValueStringOverride()
        .BindStatus());

var notification = builder.BuildNotification();
notification.Tag = tag;
notification.Group = group;

notification.Progress = new AppNotificationProgressData(1)
{
    Title = "Weekly playlist",
    Value = 0.6,
    ValueStringOverride = "15/26 songs",
    Status = "Downloading..."
};

AppNotificationManager.Default.Show(notification);

Kemudian, perbarui nilai kemajuan dengan memanggil AppNotificationManager.Default.UpdateAsync dengan instans AppNotificationProgressData baru. Tingkatkan nomor urut sehingga platform tahu ini adalah pembaruan yang lebih baru.

using Microsoft.Windows.AppNotifications;

string tag = "weekly-playlist";
string group = "downloads";

var data = new AppNotificationProgressData(2)
{
    Value = 0.7,
    ValueStringOverride = "18/26 songs"
};

await AppNotificationManager.Default.UpdateAsync(data, tag, group);

Menggunakan UpdateAsync daripada mengganti seluruh pemberitahuan memastikan bahwa pemberitahuan tetap berada di posisi yang sama di Pusat Pemberitahuan dan tidak berpindah ke atas atau ke bawah. Metode mengembalikan NotificationUpdateResult yang menunjukkan apakah pembaruan berhasil atau apakah pemberitahuan tidak dapat ditemukan (pengguna mungkin telah menutupnya).

Elemen yang mendukung pengikatan data

Elemen berikut dalam pemberitahuan aplikasi mendukung pengikatan data:

• Semua properti di AppNotificationProgressBar
• Properti Teks pada elemen teks tingkat atas

Memperbarui atau mengganti pemberitahuan

Anda dapat mengganti pemberitahuan dengan mengirim pemberitahuan baru dengan Tag dan Grup yang sama. Tabel berikut ini menjelaskan perbedaan antara mengganti dan memperbarui pemberitahuan.

	Menggantikan	Memperbarui
Posisi di Pusat Pemberitahuan	Memindahkan pemberitahuan ke bagian atas Pusat Pemberitahuan.	Meninggalkan pemberitahuan tetap ada dalam Pusat Pemberitahuan.
Memodifikasi konten	Dapat sepenuhnya mengubah semua konten dan tata letak pemberitahuan.	Hanya dapat mengubah properti yang mendukung pengikatan data (bilah kemajuan dan teks tingkat atas).
Muncul kembali sebagai popup	Dapat muncul kembali sebagai popup jika SuppressPopup adalah false (atau diatur ke true untuk mengirimkannya tanpa pemberitahuan ke Pusat Notifikasi).	Tidak akan muncul kembali sebagai popup; data pemberitahuan diperbarui secara diam-diam dalam Pusat Pemberitahuan.
Pengguna diberhentikan	Pemberitahuan penggantian selalu dikirim terlepas dari apakah pengguna menutup pemberitahuan sebelumnya.	Jika pengguna menutup pemberitahuan, pembaruan akan gagal.

Secara umum, pembaruan berguna untuk informasi yang sering berubah dan tidak memerlukan perhatian langsung pengguna, seperti kemajuan yang berubah dari 50% menjadi 65%.

Setelah urutan pembaruan Anda selesai (misalnya, file telah selesai diunduh), pertimbangkan untuk mengganti pemberitahuan untuk langkah terakhir karena:

• Pemberitahuan akhir kemungkinan memiliki tata letak yang berbeda, seperti penghapusan bilah kemajuan atau penambahan tombol baru.
• Pengguna mungkin telah menutup pemberitahuan kemajuan tetapi masih ingin melihat popup ketika operasi selesai.

Baca juga

• Gambaran umum pemberitahuan aplikasi