Skip to content

Latest commit

 

History

History
75 lines (61 loc) · 3.63 KB

nn-shobjidl_core-ifolderfilter.md

File metadata and controls

75 lines (61 loc) · 3.63 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:shobjidl_core.IFolderFilter
IFolderFilter (shobjidl_core.h)
Exposed by a client to specify how to filter the enumeration of a Shell folder by a server application.
IFolderFilter
IFolderFilter interface [Windows Shell]
IFolderFilter interface [Windows Shell]
described
_shell_IFolderFilter
shell.IFolderFilter
shobjidl_core/IFolderFilter
shell\IFolderFilter.htm
shell
fd69c11c-f4c3-4681-ae85-385460e96be9
12/05/2018
IFolderFilter, IFolderFilter interface [Windows Shell], IFolderFilter interface [Windows Shell],described, _shell_IFolderFilter, shell.IFolderFilter, shobjidl_core/IFolderFilter
shobjidl_core.h
Shobjidl.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Shobjidl.idl
Windows
19H1
IFolderFilter
shobjidl_core/IFolderFilter
c++
APIRef
kbSyntax
COM
shobjidl_core.h
IFolderFilter

IFolderFilter interface

-description

Exposed by a client to specify how to filter the enumeration of a Shell folder by a server application.

-inheritance

The IFolderFilter interface inherits from the IUnknown interface. IFolderFilter also has these types of members:

-remarks

This interface is most often used with SHBrowseForFolder to filter the contents of the tree view displayed in a folder selection dialog box. To use IFolderFilter with SHBrowseForFolder, the BIF_NEWDIALOGSTYLE flag must be set.

When your application calls SHBrowseForFolder, you become a client of the folder browser object. The folder browser object communicates with you by sending messages to a callback function, BrowseCallbackProc. The BFFM_IUNKNOWN message handled by that callback function contains a pointer to the folder browser's IUnknown interface. To filter the display of a folder's contents, do the following:

  1. Use the folder browser's QueryInterface method to request a pointer to the IFolderFilterSite interface.
  2. Call IFolderFilterSite::SetFilter, passing it a pointer to your IFolderFilter interface.
  3. The folder browser then queries IFolderFilter::GetEnumFlags and IFolderFilter::ShouldShow to determine how to filter the enumeration.

-see-also

IFolderFilterSite