ICustomDestinationList::BeginList method (shobjidl_core.h)

Memulai sesi bangunan untuk Jump List kustom.

Sintaks

HRESULT BeginList(
  [out] UINT   *pcMinSlots,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[out] pcMinSlots

Jenis: UINT*

Penunjuk yang, ketika metode ini kembali, menunjuk ke pengaturan pengguna saat ini untuk opsi Jumlah item terbaru untuk ditampilkan di Jump Lists di jendela Properti Taskbar dan Menu Mulai. Nilai defaultnya adalah 10. Ini adalah jumlah maksimum tujuan yang akan ditampilkan, dan ini adalah total semua tujuan, terlepas dari kategorinya. Lebih banyak tujuan dapat ditambahkan, tetapi tidak akan ditampilkan di UI.

Jump List akan selalu menampilkan setidaknya slot sebanyak ini—tujuan dan, jika ada ruang, tugas.

Angka ini tidak termasuk pemisah dan header bagian selama jumlah total pemisah dan header tidak melebihi empat. Pemisah dan header bagian di luar empat pertama dapat mengurangi jumlah tujuan yang ditampilkan jika spasi dibatasi. Angka ini tidak memengaruhi entri perintah standar untuk menyematkan atau mencopot, menutup jendela, atau meluncurkan instans baru. Ini juga tidak memengaruhi tugas atau item yang disematkan, jumlah yang dapat ditampilkan didasarkan pada ruang yang tersedia untuk Jump List.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka yang akan diambil dalam ppv, biasanya IID_IObjectArray, yang akan mewakili semua item yang saat ini disimpan dalam daftar tujuan yang dihapus untuk aplikasi. Informasi ini digunakan untuk memastikan bahwa item yang dihapus bukan bagian dari Jump List baru.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya merupakan IObjectArray, yang mewakili koleksi objek IShellItem dan IShellLink yang mewakili item yang dihapus.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika aplikasi memiliki ID Model Pengguna Aplikasi eksplisit (AppUserModelID), Anda harus memanggil ICustomDestinationList::SetAppID sebelum Anda memanggil metode ini.

Antarmuka IObjectArray yang diambil dalam parameter ppv mewakili daftar tujuan yang dihapus yang sama yang diambil melalui GetRemovedDestinations. Ketika Jump List baru sedang dibuat, aplikasi harus terlebih dahulu memproses tujuan yang dihapus. Data pelacakan untuk item apa pun dalam daftar yang dihapus harus dibersihkan. Jika aplikasi mencoba menyertakan item melalui AppendCategory yang ada dalam daftar tujuan yang dihapus ini, panggilan AppendCategory gagal. Ini memastikan bahwa aplikasi mematuhi pilihan item yang dihapus oleh pengguna. Setelah panggilan ke CommitList dilakukan tanpa panggilan gagal ke AppendCategory karena upaya untuk menambahkan kembali item yang dihapus telah dibuat sejak BeginList, daftar tujuan yang dihapus akan dihapus. Setelah itu, item yang dihapus sebelumnya dapat kembali ke daftar tujuan jika pengguna terus menggunakan item.

BeginList harus dipanggil untuk memulai daftar sebelum panggilan dilakukan untuk mengisinya melalui AppendCategory, AppendKnownCategory, atau AddUserTasks.

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)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 6.1 atau yang lebih baru)

Lihat juga

ICustomDestinationList

Ekstensi Taskbar