Metode ICustomDestinationList::AddUserTasks (shobjidl_core.h)
Menentukan item yang akan disertakan dalam kategori Tugas dari Jump List kustom.
Sintaks
HRESULT AddUserTasks(
[in] IObjectArray *poa
);
Parameter
[in] poa
Jenis: IObjectArray*
Penunjuk ke IObjectArray yang mewakili satu atau beberapa objek IShellLink (atau, lebih jarang, IShellItem) yang mewakili tugas.
Nilai kembali
Jenis: HRESULT
Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya.
Keterangan
Anda harus memanggil ICustomDestinationList::BeginList sebelum Anda memanggil metode ini.
Header kategori Tugas selalu diperlihatkan dalam daftar secara default, kecuali kategori kosong. Teks header ini tidak dapat diubah. Ini ditampilkan dalam bahasa yang dipilih pengguna.
Kategori Tugas , meskipun selalu muncul sebagai kategori terakhir dalam Jump List, lebih diprioritaskan daripada semua kategori lain dalam daftar. Daftar ini diisi, dan kemudian ruang yang tersisa dialokasikan untuk kategori lain. Tidak seperti kategori lain, item dalam kategori Tugas tidak dapat dihapus atau disematkan oleh pengguna. Aplikasi harus menyeimbangkan nilai kepada pengguna tugas dalam kategori ini terhadap ruang yang diperlukan untuk kategori lain.
Tugas harus berlaku untuk aplikasi secara keseluruhan; mereka tidak dimaksudkan untuk spesifik untuk jendela atau dokumen individual. Untuk tugas kontekstual yang lebih terperinci, aplikasi dapat menyediakannya melalui toolbar gambar mini.
Instans IShellLink yang disediakan melalui IObjectArray yang diarahkan oleh poa harus memberikan hal berikut:
- Baik penunjuk ke daftar pengidentifikasi item (PIDL) (SetIDList) atau jalur target (SetPath atau SetRelativePath)
- Argumen baris perintah (SetArguments)
- Lokasi ikon (SetIconLocation)
Secara opsional, bidang deskripsi (SetDescription) dapat diatur untuk menyediakan tipsalat kustom untuk item di Jump List.
Daftar tugas juga dapat menyertakan pemisah. Ini dibuat dengan menyertakan IShellLink kosong (ini adalah pengecualian tunggal untuk persyaratan daftar argumen), dan mengatur properti System.AppUserModel.IsDestListSeparator ke TRUE melalui antarmuka IPropertyStore objek IShellLink. Nilai lain dalam IShellLink akan diabaikan. Pemisah tidak mengambil ruang penuh dalam daftar dan tidak dihitung dalam jumlah item dalam daftar. Jika dua pemisah disediakan tanpa item di antaranya, salah satu pemisah tidak akan ditampilkan. Pemisah di awal atau akhir daftar juga diabaikan.
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::AppendCategory