CDN_INCLUDEITEM通知代码

[从 Windows Vista 开始, “打开 ”和“ 另存为 ”常用对话框已被 “通用项”对话框取代。 建议使用通用项对话框 API,而不是通用对话框库中的这些对话框。]

“打开 ”或“ 另存为 ”对话框发送,以确定对话框是否应在 shell 文件夹的项目列表中显示项。 当用户打开文件夹时,对话框会针对文件夹中的每一项发送 CDN_INCLUDEITEM 通知。 仅当创建对话框时设置了 OFN_ENABLEINCLUDENOTIFY 标志时,对话框才会发送此通知。

OFNHookProc 挂钩过程以WM_NOTIFY消息的形式接收此消息。

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

参数

wParam

未使用此参数。

lParam

指向 OFNOTIFYEX 结构的指针。

OFNOTIFYEX 结构包含 NMHDR 结构,其代码成员指示CDN_INCLUDEITEM通知消息。

OFNOTIFYEX 结构的 psf 成员是指向要枚举其项的文件夹的接口的指针。 pidl 成员是指向项标识符列表的指针,该列表标识相对于文件夹的项目。

返回值

如果 OFNHookProc 挂钩过程返回零,则对话框将从项列表中排除该项。

若要包含该项,请从挂钩过程中返回非零值。

备注

无论CDN_INCLUDEITEM返回的值如何,对话框始终包含同时具有 SFGAO_FILESYSTEMSFGAO_FILESYSANCESTOR 属性 项。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Commdlg.h (包括 Windows.h)

请参阅

引用

GetOpenFileName

GetSaveFileName

OFNHookProc

OFNOTIFYEX

概念性

通用对话框库