ICommDlgBrowser::IncludeObject-Methode (shobjidl_core.h)

Artikel
08/26/2023

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)

Weitere Informationen

Explorer-Browsersuche (Beispiel)

ICommDlgBrowser

Share via