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，从而提高性能。