Metode ICustomDestinationList::GetRemovedDestinations (shobjidl_core.h)
Mengambil daftar tujuan saat ini yang telah dihapus oleh pengguna dari Jump List yang ada yang dimaksudkan untuk digantikan oleh Jump List kustom ini.
Sintaksis
HRESULT GetRemovedDestinations(
[in] REFIID riid,
[out] void **ppv
);
Parameter
[in] riid
Jenis:
Referensi ke IID antarmuka untuk diambil melaluippv
[out] ppv
Jenis:
Ketika metode ini kembali, berisi penunjuk antarmuka yang diminta dalam riid. Ini biasanya merupakanIObjectArray
Mengembalikan nilai
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT.
Komentar
Item dapat dihapus dari UI Jump List melalui tindakan pengguna. Item kemudian ditandai sebagai dihapus dan tidak lagi ditampilkan. Aplikasi dapat menggunakan metode ini untuk mengetahui item mana yang telah dihapus pengguna sehingga tahu untuk tidak menampilkannya dalam daftar kustomnya. Misalnya, metode ini harus dipanggil ketika aplikasi diluncurkan, jika aplikasi tersebut tidak akan menghasilkan daftar baru melalui ICustomDestinationList::BeginList.
Sangat disarankan agar aplikasi menghapus data pelacakan tujuan apa pun ketika pengguna memilih untuk menghapus tujuan tersebut. Jika pengguna mengakses tujuan itu lagi di masa mendatang, mungkin ditambahkan kembali ke Jump List dan dapat kembali mengumpulkan data. Daftar tujuan yang dihapus yang sama yang diambil oleh metode ini diambil ketika ICustomDestinationList::BeginList dipanggil. Dalam hal ini, aplikasi tidak boleh segera mencoba untuk memasukkan kembali item yang dihapus atau panggilan ke AppendCategory akan gagal. Ini memastikan bahwa aplikasi menghormati niat pengguna untuk menghapus item.
Jika aplikasi memiliki ID Model Pengguna Aplikasi eksplisit (AppUserModelID), Anda harus memanggil SetAppID sebelum memanggil metode ini.
Bahkan jika aplikasi memanggil GetRemovedDestinations dan menemukan item dalam daftar yang memiliki probabilitas tinggi untuk dipulihkan ke Jump List lebih cepat dari Jump List kustom baru diharapkan dibuat, aplikasi harus menulis Jump List tanpa item tersebut dan menambahkannya kembali ke daftar hanya setelah pengguna kembali mengaksesnya.
Aplikasi dapat menambahkan Terbaru
Panggilan ke GetRemovedDestinations tidak menghapus data tujuan yang dihapus. Data ini diperlukan oleh BeginList untuk pembuatan daftar berikutnya. Data tujuan yang dihapus tidak lagi diperlukan dan dibersihkan setelah sesi pembuatan daftar dimulai oleh BeginList, dilanjutkan tanpa panggilan yang gagal ke AppendCategory, dan diselesaikan dengan panggilan ke CommitList.
Persyaratan
Syarat | Nilai |
---|---|
klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
server minimum yang didukung |
Windows Server 2008 R2 [hanya aplikasi desktop] |
Platform Target |
Windows |
Header |
shobjidl_core.h (termasuk Shobjidl.h) |
Pustaka |
Shell32.lib |
DLL |
Shell32.dll (versi 6.1 atau yang lebih baru) |
Lihat juga
ICustomDestinationList::BeginList
Ekstensi Taskbar
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk