ICommDlgBrowser：：IncludeObject 方法 (shobjidl_core.h)

允許通用對話框篩選檢視所顯示的物件。

語法

HRESULT IncludeObject(
  IShellView      *ppshv,
  PCUITEMID_CHILD pidl
);

ppshv

類型： IShellView*

檢視之 IShellView 介面的指標。

pidl

類型： LPCITEMIDLIST

相對於識別對象的資料夾，PIDL。

類型： HRESULT

瀏覽器應該傳回S_OK以在檢視中包含物件，或S_FALSE隱藏它。

在檔案對話框中裝載時， IEnumIDList 實作會呼叫這個方法。列舉值會呼叫這個方法，讓通用對話框篩選掉不應該顯示的物件。一般而言，檔案對話框會取得項目的顯示文字，並依擴展名進行篩選。

在 Shell 資料夾的 IDLIST 列舉值中傳回物件之前，請先呼叫這個方法。

處理有許多項目的數據源時，例如連結庫和搜尋，此方法的回呼會導致效能不佳。若要避免這種情況，請實作 GetViewFlags 並傳回CDB2GVF_NOINCLUDEITEM。這麼做可讓檢視略過呼叫 ICommDlgBrowser：：IncludeObject，進而改善效能。