LPFRHOOKPROC 回调函数 (commdlg.h)

项目
02/24/2024

接收用于 “查找 ”或“ 替换 ”对话框的默认对话框过程的消息或通知。 FRHookProc 挂钩过程是应用程序定义的或库定义的回调函数，与 FindText 或 ReplaceText 函数一起使用。

LPFRHOOKPROC 类型定义指向此回调函数的指针。 FRHookProc 是应用程序定义的函数名称的占位符。

语法

LPFRHOOKPROC Lpfrhookproc;

UINT_PTR Lpfrhookproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

参数

unnamedParam1

消息所针对的 “查找 ”或“ 替换 ”对话框的句柄。

unnamedParam2

正在接收的消息的标识符。

unnamedParam3

关于消息的附加信息。确切的含义取决于 unnamedParam2 参数的值。

unnamedParam4

关于消息的附加信息。确切的含义取决于 unnamedParam2 参数的值。

如果 unnamedParam2 参数指示 WM_INITDIALOG 消息， 则 unnamedParam4 是指向 FINDREPLACE 结构的指针，其中包含创建对话框时指定的值。

返回值

如果挂钩过程返回零，则默认对话框过程将处理消息。

如果挂钩过程返回非零值，则默认对话框过程将忽略该消息。

注解

使用 FindText 或 ReplaceText 函数创建 “查找 或替换 ”对话框时，可以提供 FRHookProc 挂钩过程来处理用于对话框过程的消息或通知。若要启用挂钩过程，请使用传递给对话框创建函数的 FINDREPLACE 结构。在 lpfnHook 成员中指定挂钩过程的地址，并在 Flags 成员中指定FR_ENABLEHOOK标志。

默认对话框过程先处理 WM_INITDIALOG 消息，然后再将其传递给挂钩过程。对于所有其他消息，挂钩过程首先接收消息。然后，挂钩过程的返回值确定默认对话过程是处理消息还是忽略它。

如果挂钩过程处理 WM_CTLCOLORDLG 消息，则必须返回用于绘制对话框背景的有效画笔句柄。通常，如果挂钩过程处理任何 WM_CTLCOLOR* 消息，则必须返回有效的画笔句柄来绘制指定控件的背景。

请勿从挂钩过程中调用 EndDialog 函数。相反，挂钩过程可以调用 PostMessage 函数，将具有 IDABORT 值的WM_COMMAND消息发布到对话框过程。发布 IDABORT 将关闭对话框，并使对话框函数返回 FALSE。如果需要了解挂钩过程关闭对话框的原因，则必须在挂钩过程与应用程序之间提供自己的通信机制。

可以对公共对话框的标准控件进行子类化。但是，对话框过程也可能对控件进行子类化。因此，在挂钩过程处理 WM_INITDIALOG 消息时，应子类控件。这可确保子类过程在对话框过程设置的子类过程之前接收特定于控件的消息。

要求

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