LPFNVIEWCALLBACK 回调函数 (shlobj_core.h)

项目
08/26/2023

[Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 支持此接口。它在后续版本的 Windows 中可能不受支持。]

定义系统文件夹视图对象使用的回调函数的原型。此函数实质上与 IShellFolderViewCB 的功能重复。

语法

LPFNVIEWCALLBACK Lpfnviewcallback;

HRESULT Lpfnviewcallback(
  [in] IShellView *psvOuter,
  [in] IShellFolder *psf,
  [in] HWND hwndMain,
       UINT uMsg,
       WPARAM wParam,
       LPARAM lParam
)
{...}

参数

[in] psvOuter

类型： IShellView*

指向 IShellView 拥有实例（如果适用）的指针。此参数可以为 NULL。

[in] psf

类型： IShellFolder*

指向消息适用的 IShellFolder 实例的指针。

[in] hwndMain

类型：HWND

窗口的句柄，该窗口包含接收消息的视图。

uMsg

类型： UINT

以下通知之一。

SFVM_ADDPROPERTYPAGES

允许回调对象提供一个页面，以添加到所选对象的 Properties 属性表。

SFVM_BACKGROUNDENUM

允许回调对象请求在后台线程上完成枚举。

SFVM_BACKGROUNDENUMDONE

通知回调对象后台枚举已完成。

SFVM_COLUMNCLICK

通知回调对象用户已单击列标题，以便对文件夹视图中的对象列表进行排序。

SFVM_DEFITEMCOUNT

允许回调对象指定文件夹视图中的项目数。

SFVM_DEFVIEWMODE

允许回调对象指定视图模式。

SFVM_DIDDRAGDROP

通知回调函数拖放操作已开始。

SFVM_FSNOTIFY

通知回调对象发生了影响其项之一的事件。

SFVM_GETANIMATION

允许回调对象指定在后台线程上枚举项时显示动画。

SFVM_GETBUTTONINFO

允许回调对象将按钮添加到工具栏。

SFVM_GETBUTTONS

允许回调对象指定要添加到工具栏中的按钮。

SFVM_GETDETAILSOF

允许回调对象提供 Shell 文件夹中项的详细信息。仅当对 IShellFolder2：：GetDetailsOf 的调用失败且没有可供调用的 IShellDetails：：GetDetailsOf 方法时，才使用。

SFVM_GETHELPTEXT

允许回调对象为菜单项或工具栏按钮指定帮助文本字符串。

SFVM_GETHELPTOPIC

允许回调对象指定帮助文件和主题。

SFVM_GETNOTIFY

指定哪些事件将为给定项生成 SFVM_FSNOTIFY 消息。

SFVM_GETPANE

允许回调对象提供用于显示 Internet 区域信息的状态栏窗格。

SFVM_GETSORTDEFAULTS

允许回调对象指定默认排序参数。

SFVM_GETTOOLTIPTEXT

允许回调对象为菜单项或工具栏按钮指定工具提示文本字符串。

SFVM_GETZONE

允许回调对象提供 Internet 区域信息。

SFVM_INITMENUPOPUP

允许回调对象修改项的上下文菜单。

SFVM_INVOKECOMMAND

通知回调对象已调用其工具栏或菜单命令之一。

SFVM_MERGEMENU

允许回调对象将菜单项合并到 Windows 资源管理器菜单中。

SFVM_QUERYFSNOTIFY

允许回调对象注册文件夹，以便对文件夹视图所做的更改将生成通知。

SFVM_SETISFV

通知容器站点的回调对象。仅当不支持 IObjectWithSite：：SetSite 且使用 SHCreateShellFolderViewEx 时，才使用此选项。

SFVM_SIZE

通知回调对象文件夹视图已调整大小。

SFVM_THISIDLIST

允许回调对象指定视图的 PIDL。仅当 IPersistIDList：：SetIDList 和 IPersistFolder2：：GetCurFolder 失败时，才使用此选项。

SFVM_UNMERGEMENU

通知回调对象正在删除菜单。

SFVM_UPDATESTATUSBAR

允许回调对象请求更新状态栏。

SFVM_WINDOWCREATED

通知回调对象正在创建文件夹视图窗口。

wParam

类型：WPARAM

其他信息取决于 uMsg 中的值。有关特定要求，请参阅各个通知页面。

lParam

类型：LPARAM