IFolderFilter-Schnittstelle (shobjidl_core.h)

  • Artikel

Wird von einem Client verfügbar gemacht, um anzugeben, wie die Enumeration eines Shellordners nach einer Serveranwendung gefiltert werden soll.

Vererbung

Die IFolderFilter-Schnittstelle erbt von der IUnknown-Schnittstelle . IFolderFilter verfügt auch über folgende Membertypen:

Methoden

Die IFolderFilter-Schnittstelle verfügt über diese Methoden.

 
IFolderFilter::GetEnumFlags

Ermöglicht es einem Client, anzugeben, welche Klassen von Objekten in einem Shellordner aufgelistet werden sollen. Gibt bei Verwendung mit SHBrowseForFolder die Klasse oder Klassen von Elementen an, die in der Dialogfeldstrukturansicht angezeigt werden sollen und welche Klasse oder Klassen nicht.
IFolderFilter::ShouldShow

Gibt an, ob ein einzelnes Element über den Filter zugelassen werden soll und welches blockiert werden soll.

Hinweise

Diese Schnittstelle wird am häufigsten mit SHBrowseForFolder verwendet, um den Inhalt der Strukturansicht zu filtern, die in einem Dialogfeld zur Ordnerauswahl angezeigt wird. Um IFolderFilter mit SHBrowseForFolder zu verwenden, muss das flag BIF_NEWDIALOGSTYLE festgelegt werden.

Wenn Ihre Anwendung SHBrowseForFolder aufruft, werden Sie zum Client des Ordnerbrowserobjekts. Das Ordnerbrowserobjekt kommuniziert mit Ihnen, indem Nachrichten an die Rückruffunktion BrowseCallbackProc gesendet werden. Die BFFM_IUNKNOWN Nachricht, die von dieser Rückruffunktion verarbeitet wird, enthält einen Zeiger auf die IUnknown-Schnittstelle des Ordnerbrowsers. Gehen Sie wie folgt vor, um die Anzeige des Inhalts eines Ordners zu filtern:

  1. Verwenden Sie die QueryInterface-Methode des Ordnerbrowsers, um einen Zeiger auf die IFolderFilterSite-Schnittstelle anzufordern.
  2. Rufen Sie IFolderFilterSite::SetFilter auf, und übergeben Sie einen Zeiger auf Ihre IFolderFilter-Schnittstelle .
  3. Der Ordnerbrowser fragt dann IFolderFilter::GetEnumFlags und IFolderFilter::ShouldShow ab, um zu bestimmen, wie die Enumeration gefiltert werden soll.

Anforderungen

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

Weitere Informationen

IFolderFilterSite