CDN_INCLUDEITEM codice di notifica

[A partire da Windows Vista, le finestre di dialogo Apri e Salva con nome comune sono state sostituite dalla finestra di dialogo Elemento comune. È consigliabile usare l'API Finestra di dialogo elementi comuni anziché queste finestre di dialogo dalla libreria della finestra di dialogo comune.

Inviato da una finestra di dialogo Apri o Salva con nome per determinare se la finestra di dialogo deve visualizzare un elemento nell'elenco di elementi di una shell. Quando l'utente apre una cartella, la finestra di dialogo invia una notifica CDN_INCLUDEITEM per ogni elemento della cartella. La finestra di dialogo invia questa notifica solo se il flag di OFN_ENABLEINCLUDENOTIFY è stato impostato quando è stata creata la finestra di dialogo.

La procedura di hook OFNHookProc riceve questo messaggio sotto forma di messaggio di WM_NOTIFY .

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

Parametri

wParam

Questo parametro non viene usato.

lParam

Puntatore a una struttura OFNOTIFYEX .

La struttura OFNOTIFYEX contiene una struttura NMHDR il cui membro del codice indica il messaggio di notifica CDN_INCLUDEITEM .

Il membro psf della struttura OFNOTIFYEX è un puntatore a un'interfaccia per la cartella i cui elementi vengono enumerati. Il membro pidl è un puntatore a un elenco di identificatori di elemento che identifica l'elemento relativo alla cartella.

Valore restituito

Se la procedura di hook OFNHookProc restituisce zero, la finestra di dialogo esclude l'elemento dall'elenco di elementi.

Per includere l'elemento, restituire un valore diverso da zero dalla procedura di hook.

Commenti

La finestra di dialogo include sempre elementi con attributi di SFGAO_FILESYSTEM e SFGAO_FILESYSANCESTOR , indipendentemente dal valore restituito da CDN_INCLUDEITEM.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Commdlg.h (includono Windows.h)

Vedi anche

Riferimento

Getopenfilename

GetSaveFileName

OFNHookProc

OFNOTIFYEX

Informazioni concettuali

Libreria di finestre di dialogo comuni