Metode ICommDlgBrowser::IncludeObject (shobjidl_core.h)
Memungkinkan kotak dialog umum untuk memfilter objek yang ditampilkan tampilan.
Sintaks
HRESULT IncludeObject(
IShellView *ppshv,
PCUITEMID_CHILD pidl
);
Parameter
ppshv
Jenis: IShellView*
Penunjuk ke antarmuka IShellView tampilan.
pidl
Jenis: LPCITEMIDLIST
PIDL, relatif terhadap folder, yang mengidentifikasi objek .
Nilai kembali
Jenis: HRESULT
Browser harus mengembalikan S_OK untuk menyertakan objek dalam tampilan, atau S_FALSE untuk menyembunyikannya.
Keterangan
Metode ini dipanggil oleh implementasi IEnumIDList ketika dihosting dalam kotak dialog file. Enumerator memanggil metode ini untuk membiarkan kotak dialog umum memfilter objek yang tidak boleh ditampilkan. Biasanya, kotak dialog file akan mendapatkan teks tampilan item, dan memfilter menurut ekstensi.
Catatan untuk Aplikasi Panggilan
Panggil metode ini sebelum mengembalikan objek di enumerator IDLIST folder Shell.Saat berhadapan dengan sumber data yang memiliki banyak item, seperti pustaka dan pencarian, panggilan balik ke metode ini menghasilkan performa yang buruk. Untuk menghindari situasi tersebut, terapkan GetViewFlags dan kembalikan CDB2GVF_NOINCLUDEITEM. Melakukannya memungkinkan tampilan untuk melewati panggilan ICommDlgBrowser::IncludeObject, sehingga meningkatkan performa.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shobjidl_core.h (termasuk Shobjidl.h) |
| DLL | Shell32.dll (versi 4.0 atau yang lebih baru) |