CDN_INCLUDEITEM Benachrichtigungscode
[Ab Windows Vista wurden die allgemeinen Dialogfelder Öffnen und Speichern unter durch das Dialogfeld "Allgemeines Element" ersetzt. Es wird empfohlen, die Dialogfeld-API für allgemeine Elemente anstelle dieser Dialogfelder aus der Allgemeinen Dialogfeldbibliothek zu verwenden.]
Wird von einem 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 Codemember die CDN_INCLUDEITEM Benachrichtigung angibt.
Das psf-Element der OFNOTIFYEX-Struktur ist ein Zeiger auf eine Schnittstelle für den Ordner, dessen Elemente aufgelistet werden. Das pidl-Element ist ein Zeiger auf eine Elementbezeichnerliste, die das Element relativ zum Ordner identifiziert.
Rückgabewert
Wenn die HOOK-Prozedur OFNHookProc null zurückgibt, schließt das Dialogfeld das Element aus der Liste der Elemente aus.
Um das Element einzuschließen, geben Sie einen nonzero-Wert aus der Hookprozedur zurück.
Bemerkungen
Das Dialogfeld enthält immer Elemente, die sowohl über das SFGAO_FILESYSTEM - als auch über SFGAO_FILESYSANCESTOR-Attribute verfügen, unabhängig vom von CDN_INCLUDEITEM zurückgegebenen Wert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
Weitere Informationen
-
Referenz
-
Konzept