ICommDlgBrowser::IncludeObject-Methode (shobjidl_core.h)
Ermöglicht dem allgemeinen Dialogfeld das Filtern von Objekten, die in der Ansicht angezeigt werden.
Syntax
HRESULT IncludeObject(
IShellView *ppshv,
PCUITEMID_CHILD pidl
);
Parameter
ppshv
Typ: IShellView*
Ein Zeiger auf die IShellView-Schnittstelle der Ansicht.
pidl
Typ: LPCITEMIDLIST
Eine PIDL relativ zum Ordner, die das Objekt identifiziert.
Rückgabewert
Typ: HRESULT
Der Browser sollte S_OK zurückgeben, um das Objekt in die Ansicht einzuschließen, oder S_FALSE, um es auszublenden.
Hinweise
Diese Methode wird von der IEnumIDList-Implementierung aufgerufen, wenn sie in Dateidialogfeldern gehostet wird. Der Enumerator ruft diese Methode auf, damit das allgemeine Dialogfeld Objekte herausfiltert, die nicht angezeigt werden sollen. In der Regel erhalten die Dateidialogfelder den Anzeigetext des Elements und filtern nach der Erweiterung.
Hinweis zum Aufrufen von Anwendungen
Rufen Sie diese Methode auf, bevor Sie ein Objekt im IDLIST-Enumerator des Shellordners zurückgeben.Bei Datenquellen, die über viele Elemente verfügen, z. B. Bibliotheken und Suchvorgänge, führt der Rückruf dieser Methode zu einer schlechten Leistung. Um diese Situation zu vermeiden, implementieren Sie GetViewFlags , und geben Sie CDB2GVF_NOINCLUDEITEM zurück. Dadurch kann die Ansicht den Aufruf von ICommDlgBrowser::IncludeObject überspringen und dadurch die Leistung verbessern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (shobjidl.h einschließen) |
| DLL | Shell32.dll (Version 4.0 oder höher) |