_CDN INCLUDEITEM-Benachrichtigungscode

[Ab Windows Vista wurden die allgemeinen Dialogfelder Öffnen und Speichern unter durch den Allgemeinen Elementdialog ersetzt. Es wird empfohlen, anstelle dieser Dialogfelder aus der Common Dialog Box Library die API für den Allgemeinen Elementdialog zu verwenden.]

Wird über das Dialogfeld Öffnen oder Speichern unter gesendet, um zu bestimmen, ob im Dialogfeld ein Element in der Elementliste eines Shellordners angezeigt werden soll. Wenn der Benutzer einen Ordner öffnet, sendet das Dialogfeld eine CDN _ INCLUDEITEM-Benachrichtigung für jedes Element im Ordner. Das Dialogfeld sendet diese Benachrichtigung nur, wenn das OFN _ ENABLEINCLUDENOTIFY-Flag beim Erstellen des Dialogfelds festgelegt wurde.

Ihre OFNHookProc-Hookprozedur empfängt diese Nachricht in Form einer WM _ NOTIFY-Nachricht.

#define CDN_FIRST               (0U-601U)
#define CDN_INCLUDEITEM         (CDN_FIRST - 0x0007)

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Ein Zeiger auf eine OFNOTIFYEX-Struktur.

Die OFNOTIFYEX-Struktur enthält eine NMHDR-Struktur, deren Code member die CDN _ INCLUDEITEM-Benachrichtigungsmeldung angibt.

Der psf-Member der OFNOTIFYEX-Struktur ist ein Zeiger auf eine Schnittstelle für den Ordner, dessen Elemente aufzählt werden. Das pidl-Element ist ein Zeiger auf eine Elementbezeichnerliste, die das Element relativ zum Ordner identifiziert.

Rückgabewert

Wenn die OFNHookProc-Hookprozedur 0 (null) zurückgibt, schließt das Dialogfeld das Element aus der Liste der Elemente aus.

Um das Element ein include zu erhalten, geben Sie einen Wert ungleich 0 (null) aus der Hookprozedur zurück.

Hinweise

Das Dialogfeld enthält immer Elemente, die sowohl über die ATTRIBUTE SFGAO _ FILESYSTEM als auch SFGAO _ FILESYSANCESTOR verfügen, unabhängig vom Wert, der von CDN _ INCLUDEITEM zurückgegeben wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Commdlg.h (include Windows.h)

Weitere Informationen

Referenz

GetOpenFileName

GetSaveFileName

OFNHookProc

OFNOTIFYEX

Konzeptionellen

Allgemeine Dialogfeldbibliothek