该函数创建一个
系统定义的无模式Find对话框,为使用户指定一个串来查找文本内的文字。
返回值:如果
函数调用成功,返回值是对话框的
窗口句柄。可以使用窗口句柄与对话框联系或关闭它;如果
函数调用失败,返回值为NULL。若想获得更多的错误信息,请调用CommDlgExtended
Error函数。其返回值如下:
Find
Text函数不执行查找操作,相反,对话框把FINDMSGSTRING己登记的信息传送到对话框窗口的
窗口过程。当创建对话框时FINDReplace结构中的hwndOwner成员是窗口句柄。
调用Find Text函数前,必须调用RegisterWindowMessage函数以得到FINDMSGSTRING信息的标识符,对话框函数在用户点击FindNext按钮或对话框被关闭时利用此标识符传送信息。FINDMSGSTRING信息的IParam参数包含一个指向FINDREPLACE结构的指针,此结构的Flags成员显示引起信息的事件,而结构其它成员则指明了用户输入的数据。
若想创建对话框,必须利用应用程序的主信息链中的
IsDialogMessage函数来保证对话框正确处理键盘输入,例如Tab和Esc键。
IsDialogMessage返回值显示Find对话框是否处理信息。
可以为Find对话框提供一个挂钩函数
FRHookProc。挂钩函数可处理发送到对话框中的信息。为使挂钩函数生效,可设置HNDREPLACE结构的Flags成员的FR_ENABLEHOOK标志,且指定IpfnHook成员中挂钩函数的地址。