Antarmuka ICustomDestinationList (shobjidl_core.h)

  • Artikel

Mengekspos metode yang memungkinkan aplikasi menyediakan Jump List kustom, termasuk tujuan dan tugas, untuk ditampilkan di taskbar.

Warisan

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

Metode

Antarmuka ICustomDestinationList memiliki metode ini.

 
ICustomDestinationList::AbortList

Menghentikan sesi pembuatan Jump List yang dimulai oleh ICustomDestinationList::BeginList tanpa menerapkan perubahan apa pun.
ICustomDestinationList::AddUserTasks

Menentukan item yang akan disertakan dalam kategori Tugas dari Jump List kustom.
ICustomDestinationList::AppendCategory

Menentukan kategori kustom dan tujuan yang dikandungnya, untuk dimasukkan dalam Jump List kustom.
ICustomDestinationList::AppendKnownCategory

Menentukan bahwa kategori Sering atau Terbaru harus disertakan dalam Jump List kustom.
ICustomDestinationList::BeginList

Memulai sesi bangunan untuk Jump List kustom.
ICustomDestinationList::CommitList

Menyatakan bahwa Jump List yang dimulai oleh panggilan ke ICustomDestinationList::BeginList selesai dan siap untuk ditampilkan.
ICustomDestinationList::D eleteList

Menghapus Jump List kustom untuk aplikasi tertentu.
ICustomDestinationList::GetRemovedDestinations

Mengambil daftar tujuan saat ini yang telah dihapus oleh pengguna dari Jump List yang ada yang dimaksudkan untuk digantikan oleh Jump List kustom ini.
ICustomDestinationList::SetAppID

Menentukan ID Model Pengguna Aplikasi (AppUserModelID) unik untuk aplikasi yang tombol taskbar-nya akan menyimpan Jump List kustom yang dibangun melalui metode antarmuka ini. Metode ini bersifat opsional.

Keterangan

Kapan Harus Menerapkan

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

Kapan Harus Digunakan

Jump Lists berisi daftar tujuan dan tugas.
  • Tujuan adalah item yang muncul di kategori Terbaru, Sering, atau kustom, berdasarkan penggunaan individu. Tujuan dapat berupa file, folder, situs web, atau item berbasis konten lainnya, tetapi belum tentu didukung file. Tujuan dapat dianggap sebagai hal-hal atau kata benda. Tujuan dapat disematkan atau dihapus dari Jump List oleh pengguna. Mereka umumnya diwakili oleh objek IShellItem tetapi juga dapat menjadi objek IShellLink .
  • Tugas adalah tindakan umum yang dilakukan dalam aplikasi yang berlaku untuk semua pengguna aplikasi tersebut terlepas dari pola penggunaan individu. Tugas dapat dianggap sebagai tindakan atau kata kerja. Tugas tidak dapat disematkan atau dihapus. Mereka diwakili oleh objek IShellLink .

Taskbar menyediakan setiap tombol taskbar dengan Jump List. Secara default, Jump List berisi kategori Terbaru , yang diisi secara otomatis untuk aplikasi berbasis file melalui SHAddToRecentDocs atau dialog file umum. Untuk mengganti kategori Terbaru dengan kategori Sering atau menentukan, menambahkan, dan mengisi kategori kustomnya sendiri, aplikasi harus memanggil metode antarmuka ini. Aplikasi ini juga dapat menyediakan tugasnya sendiri berdasarkan arsitektur aplikasi dan penggunaan yang dimaksudkan.

Catatan Aplikasi harus menjadi handler terdaftar untuk tipe file agar item tipe tersebut muncul di Jump List-nya. Namun, itu tidak perlu menjadi handler default untuk jenis file tersebut.
 
Jump List kustom dimaksudkan untuk menyajikan konten yang telah dianggap signifikan oleh aplikasi berdasarkan penggunaan aplikasi sebelumnya atau melalui tindakan yang telah menunjukkan bahwa item sangat penting bagi pengguna, seperti pengguna menambahkan item ke daftar Favorit.

Aplikasi harus memanggil objek ini untuk menyediakan Jump List kustom ke UI taskbar. Sistem tidak pernah mengkueri aplikasi untuk informasi tersebut.

Saat aplikasi menyediakan Jump List kustom, dibutuhkan tanggung jawab tertentu di sekitar daftar tersebut. Kategori kustom harus diisi dengan cara yang konsisten dengan penggunaan Jump List yang dimaksudkan. Item dalam daftar harus diperiksa validitasnya atau gagal dengan baik jika telah dihapus. Jika pengguna menghapus item dari daftar, penghapusan tersebut harus dihormati.

Jump List kustom tidak pernah benar-benar diperbarui dalam arti mengubah elemen dalam daftar yang ada. Sebaliknya, daftar lama diganti dengan daftar baru.

Urutan dasar panggilan metode ICustomDestinationList untuk membangun dan menampilkan Jump List kustom adalah sebagai berikut:

  1. SetAppID (diperlukan hanya jika aplikasi menyediakan AppUserModelID sendiri)
  2. BeginList
  3. AppendCategory, AppendKnownCategory, AddUserTasks, atau kombinasi apa pun dari ketiga metode tersebut.
  4. CommitList

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