CDN_INCLUDEITEM código de notificación

[A partir de Windows Vista, los cuadros de diálogo Abrir y Guardar como comunes se han reemplazado por el cuadro de diálogo elemento común. Se recomienda usar common Item Dialog API en lugar de estos cuadros de diálogo de la Biblioteca de cuadros de diálogo comunes.]

Enviado por un cuadro de diálogo Abrir o Guardar como para determinar si el cuadro de diálogo debe mostrar un elemento en la lista de elementos de una carpeta de shell. Cuando el usuario abre una carpeta, el cuadro de diálogo envía una notificación de CDN_INCLUDEITEM para cada elemento de la carpeta. El cuadro de diálogo envía esta notificación solo si se estableció la marca de OFN_ENABLEINCLUDENOTIFY cuando se creó el cuadro de diálogo.

El procedimiento de enlace OFNHookProc recibe este mensaje en forma de mensaje WM_NOTIFY .

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

Parámetros

wParam

Este parámetro no se utiliza.

lParam

Puntero a una estructura OFNOTIFYEX .

La estructura OFNOTIFYEX contiene una estructura NMHDR cuyo miembro de código indica el mensaje de notificación CDN_INCLUDEITEM .

El miembro psf de la estructura OFNOTIFYEX es un puntero a una interfaz para la carpeta cuyos elementos se enumeran. El miembro pidl es un puntero a una lista de identificadores de elemento que identifica el elemento relativo a la carpeta.

Valor devuelto

Si el procedimiento de enlace OFNHookProc devuelve cero, el cuadro de diálogo excluye el elemento de la lista de elementos.

Para incluir el elemento, devuelva un valor distinto de cero del procedimiento de enlace.

Comentarios

El cuadro de diálogo siempre incluye elementos que tienen los atributos SFGAO_FILESYSTEM y SFGAO_FILESYSANCESTOR , independientemente del valor devuelto por CDN_INCLUDEITEM.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Commdlg.h (incluye Windows.h)

Consulte también

Referencia

GetOpenFileName

GetSaveFileName

OFNHookProc

OFNOTIFYEX

Conceptual

Biblioteca de cuadros de diálogo comunes