Share via

Metode ICustomDestinationList::AddUserTasks (shobjidl_core.h)

  • Artikel

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.

Catatan Setiap IShellLink yang digunakan di sini harus mendeklarasikan daftar argumen melalui SetArguments. Menambahkan objek IShellLink tanpa argumen ke kategori kustom tidak didukung. Pengguna tidak dapat menyematkan atau melepas sematan tipe item ini dari Jump List, juga tidak dapat ditambahkan atau dihapus.
 

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.

Catatan Sangat disarankan agar daftar tugas menjadi statis. Daftar tugas harus tetap sama terlepas dari status atau status aplikasi—tugas ini tersedia bahkan ketika aplikasi tidak berjalan. Tidak ada larangan terprogram untuk tidak menggunakan AddUserTasks untuk memvariasikan daftar tugas saat diperbarui, tetapi Anda harus mempertimbangkan bahwa ini dapat membingungkan pengguna yang tidak mengharapkan bagian Jump List tersebut berubah. Namun, jika aplikasi memilih untuk mengubah status tugas, seperti "Masuk" menjadi "Keluar", aplikasi tersebut bertanggung jawab untuk memastikan bahwa daftar tugas sudah benar dan terbaru. Selain itu, jika aplikasi secara tiba-tiba dimatikan, taskbar akan menggunakan versi baik terakhir yang diketahui dari daftar tugas tanpa memanggil ke aplikasi untuk memintanya, yang mengarah ke kemungkinan item yang kedaluwarsa.
 

Instans IShellLink yang disediakan melalui IObjectArray yang diarahkan oleh poa harus memberikan hal berikut:

Nama tampilan harus diatur melalui properti System.Title (PKEY_Title) item. Properti dapat langsung menahan nama tampilan atau dapat menjadi representasi string tidak langsung, seperti "@shell32.dll,-1324", untuk menggunakan string yang disimpan. String tidak langsung memungkinkan nama item ditampilkan dalam bahasa yang dipilih pengguna.

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

ICustomDestinationList::AppendCategory

ICustomDestinationList::AppendKnownCategory

Ekstensi Bilah Tugas