Bagikan melalui

Antarmuka IApplicationDestinations (shobjidl_core.h)

  • Artikel

Mengekspos metode yang memungkinkan aplikasi menghapus satu atau semua tujuan dari kategori Terbaru atau Sering dalam Jump List.

Warisan

Antarmuka IApplicationDestinations mewarisi dari antarmuka IUnknown . IApplicationDestinations juga memiliki jenis anggota ini:

Metode

Antarmuka IApplicationDestinations memiliki metode ini.

 
IApplicationDestinations::RemoveAllDestinations

Menghapus semua entri tujuan dari kategori Terbaru dan Sering dalam Jump List aplikasi.
IApplicationDestinations::RemoveDestination

Menghapus satu tujuan dari kategori Terbaru dan Sering dalam Jump List.
IApplicationDestinations::SetAppID

Menentukan ID Model Pengguna Aplikasi (AppUserModelID) unik untuk aplikasi dari yang tombol taskbar-nya Jump List metode antarmuka ini akan menghapus tujuan. Metode ini bersifat opsional.

Keterangan

Kapan Harus Menerapkan

Implementasi antarmuka ini disediakan di Windows sebagai CLSID_ApplicationDestinations. Antarmuka ini tidak diimplementasikan oleh pihak ketiga.

Kapan Harus Digunakan

Aplikasi memanggil metode antarmuka ini ketika ingin menghapus item dari tujuan jump list yang dibuat secara otomatis. Tujuan ini, yang ditemukan dalam kategori Terbaru atau Sering , dihasilkan melalui panggilan ke SHAddToRecentDocs, baik secara eksplisit atau oleh sistem ketika file dibuka melalui Windows Explorer atau dialog file umum digunakan untuk membuka, menyimpan, atau membuat file.

Aplikasi harus memanggil metode IApplicationDestinations dalam situasi berikut:

  • Ketika aplikasi dihapus instalannya.
  • Saat pengguna menghapus riwayat.
  • Saat pengguna menonaktifkan pelacakan tujuan di halaman Pengaturan atau Opsi aplikasi.
  • Saat pengguna menghapus tujuan dari dalam aplikasi. Ini sangat penting dalam kasus tujuan yang bukan file. Dalam kasus tujuan non-file—umumnya, meskipun tidak selalu, item IShellLink —adalah tanggung jawab aplikasi untuk menghapus tujuan dari daftar ketika mendeteksi bahwa itu tidak ada lagi.

Jika pengguna menonaktifkan pelacakan penggunaan dalam pengaturan privasi aplikasi, aplikasi bertanggung jawab untuk menghapus data yang ada dan juga menghentikan sistem mengumpulkan data penggunaan pada item tersebut di masa mendatang. Ini dilakukan dengan mengatur nilai NoRecentDocs di semua pendaftaran jenis file aplikasi. Lihat FTA_NoRecentDocs untuk informasi selengkapnya.

Metode IApplicationDestinations hanya digunakan dengan kategori Terbaru atau Sering yang dihasilkan secara otomatis. Mereka tidak menghapus item yang telah disematkan pengguna ke Jump List. Item tersebut tidak dapat dihapus secara terprogram; hanya pengguna yang dapat menghapusnya. Metode ini juga tidak berpengaruh pada kategori kustom atau daftar tugas.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

Ekstensi Bilah Tugas