IFileDialog::SetFilter-Methode (shobjidl_core.h)

[Veraltet. SetFilter ist ab Windows 7 nicht mehr verfügbar.]

Legt den Filter fest.

Syntax

HRESULT SetFilter(
  IShellItemFilter *pFilter
);

Parameter

pFilter

Typ: IShellItemFilter*

Ein Zeiger auf den festzulegenden IShellItemFilter .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode kann verwendet werden, wenn die Anwendung eine spezielle Filterung durchführen muss, um einige Elemente aus der Ansicht des Dialogfelds zu entfernen. IncludeItem wird für jedes Element aufgerufen, das normalerweise in der Ansicht enthalten wäre. GetEnumFlagsForItem wird nicht verwendet. Zum Filtern nach Dateityp sollte IFileDialog::SetFileTypes verwendet werden, da es in Ordnern mit einer großen Anzahl von Elementen möglicherweise eine bessere Leistung bietet als das Anwenden eines IShellItemFilter.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)