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. |
|
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 |
|
|
|
|
|
|
Exposed by a client to specify how to filter the enumeration of a Shell folder by a server application.
The IFolderFilter interface inherits from the IUnknown interface. IFolderFilter also has these types of members:
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:
- Use the folder browser's QueryInterface method to request a pointer to the IFolderFilterSite interface.
- Call IFolderFilterSite::SetFilter, passing it a pointer to your IFolderFilter interface.
- The folder browser then queries IFolderFilter::GetEnumFlags and IFolderFilter::ShouldShow to determine how to filter the enumeration.