IFileDialog::SetFilter 方法 (shobjidl_core.h)

[已弃用。 自 Windows 7 起,SetFilter 不再可供使用。]

设置筛选器。

语法

HRESULT SetFilter(
  IShellItemFilter *pFilter
);

参数

pFilter

类型: IShellItemFilter*

指向要设置的 IShellItemFilter 的 指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

如果应用程序需要执行特殊筛选以从对话框的视图中删除某些项,则可以使用此方法。 将为通常包含在视图中的每个项调用 IncludeItem。 不使用 GetEnumFlagsForItem。 若要按文件类型进行筛选,应使用 IFileDialog::SetFileTypes ,因为在包含大量项的文件夹中,它的性能可能优于应用 IShellItemFilter

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)