ICommDlgBrowser ::IncludeObject, méthode (shobjidl_core.h)
Permet à la boîte de dialogue commune de filtrer les objets affichés par la vue.
Syntaxe
HRESULT IncludeObject(
IShellView *ppshv,
PCUITEMID_CHILD pidl
);
Paramètres
ppshv
Type : IShellView*
Pointeur vers l’interface IShellView de la vue.
pidl
Type : LPCITEMIDLIST
PIDL, relatif au dossier, qui identifie l’objet .
Valeur retournée
Type : HRESULT
Le navigateur doit retourner S_OK pour inclure l’objet dans la vue, ou S_FALSE le masquer.
Remarques
Cette méthode est appelée par l’implémentation IEnumIDList lorsqu’elle est hébergée dans des boîtes de dialogue de fichier. L’énumérateur appelle cette méthode pour permettre à la boîte de dialogue commune de filtrer les objets qui ne doivent pas être affichés. En règle générale, les boîtes de dialogue de fichier obtiennent le texte d’affichage de l’élément et filtrent en fonction de l’extension.
Remarque concernant l’appel d’applications
Appelez cette méthode avant de renvoyer un objet dans l’énumérateur IDLIST du dossier Shell.Lorsque vous traitez des sources de données qui ont de nombreux éléments, tels que des bibliothèques et des recherches, le rappel à cette méthode entraîne des performances médiocres. Pour éviter cette situation, implémentez GetViewFlags et retournez CDB2GVF_NOINCLUDEITEM. Cela permet à l’affichage d’ignorer l’appel de ICommDlgBrowser ::IncludeObject, améliorant ainsi les performances.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (incluez Shobjidl.h) |
| DLL | Shell32.dll (version 4.0 ou ultérieure) |