IFolderFilter::Metode ShouldShow (shobjidl_core.h)

Menentukan apakah item individual harus diizinkan melalui filter dan yang harus diblokir. Saat digunakan dengan SHBrowseForFolder, tentukan item mana yang harus ditampilkan dalam tampilan pohon kotak dialog dan mana yang tidak boleh. Penentuan untuk menampilkan atau tidak menampilkan item terserah aplikasi.

Sintaks

HRESULT ShouldShow(
  [in] IShellFolder      *psf,
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] PCUITEMID_CHILD   pidlItem
);

Parameter

[in] psf

Jenis: IShellFolder*

Penunjuk ke antarmuka IShellFolder folder.

[in] pidlFolder

Jenis: PCIDLIST_ABSOLUTE

PIDL folder.

[in] pidlItem

Jenis: PCUITEMID_CHILD

PIDL relatif item anak dari pidlFolder yang dimaksud.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika item harus ditampilkan, S_FALSE jika tidak boleh ditampilkan, atau kode kesalahan standar jika terjadi kesalahan. Jika terjadi kesalahan, item tidak ditampilkan.

Keterangan

Host memanggil metode ini untuk setiap item dalam folder yang dirujuk oleh psf atau pidlFolder.

Disarankan agar implementasi Anda mengonversi informasi psf dan pidlItem menjadi IShellItem, yang lebih mudah dikonsumsi. Contoh berikut menunjukkan ini:

STDMETHODIMP ShouldShow(IShellFolder *psf, 
                        PCIDLIST_ABSOLUTE pidlFolder, 
                        PCUITEMID_CHILD pidlItem)
{
    IShellItem *psi;

    HRESULT hr = SHCreateItemWithParent(NULL, psf, pidlItem, IID_PPV_ARGS(&psi));
    if (SUCCEEDED(hr))
    {
        // Determine here whether the item should be shown. This determination
        // is application-dependent.

        psi->Release();
    }

    return hr;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

IFolderFilter