FRHookProc

FRHookProc，該函式是由應用程式定義或庫定義的回調函式。它和FindText函式或Replace Text函式一定使用。

函式功能

該函式是由應用程式定義或庫定義的回調函式。它和FindText函式或Replace Text函式一定使用。掛鈎函式接收用於Find或Replace公共對話框的預設對話框函式的訊息和通告。

LPFRHOOKPROC類型定義了一個指向此回調函式的指針，FRHookProc是一個應用程式定義的函式名的位置持有者。數原型：UINT CALLBACK FRHookProc（HWND hdlg，UINT uiMsg WPARAM wParam，LPARAM IParam）；

參數

hdlg：指向訊息所傳送到的Find或Replace公共對話框視窗的句柄。

uiMsg：指定有放的訊息。

wParam：指定有關訊息的另外的信息，精確的意義要根據uiMsg參數的值來定。

IParam：指定有關訊息的另外的信息，精確的意義要根據uiMsg參數的值來定。如果uiMsg的參數表明WM_INItDIALOG訊息。IParam是一個指向FINDREPLACE結構的指針，該結構包含公共對話框創建時指定的值。

返回值

如果掛鈎函式返回零，預設對話框函式處理訊息；如果掛鈎函式返回非零值，預設對話框函式忽略訊息。

備註：當用FindText，或ReplaceText函式創建一個Find或Replace公共對話框時，可提供一個處理與公共對話框函式有關的信息和通告的FRHookProc掛鈎函式。為使掛鈎函式生效，套用傳送到公共創建函式的FINDREPLACE結構且指定IpfnHook成員中掛鈎函式的地址和指定Flags成員中FR_ENABLEHOOK標誌的地址。預設對話框函式處理WM_INTTDIALOG訊息後，把它傳遞給掛鈎函式，對於其他所有訊息，掛鈎函式首先接收訊息，然後掛鈎函式的返回值決定預設對話框函式是處理訊息或忽略它。如果掛鈎函式處理WM_CTLCOLORDLG訊息，那么必須返回一個有效的刷子句柄，以便繪製對話框的背景。總之如果掛鈎函式處理任何一種WM_HLOLOR信息，那么必須返回一個有效的刷子句柄以繪製指定控制的背景。

不須從掛鈎函式調用EndDialog函式。相反，掛鈎函式能調用PostMessage函式把帶有IDABORT值的一個WM_COMMAND信息傳送給對話框函式Posting IDABORT關閉對話框，使對話框函式返回FALSE值，若要了解為什麼掛鈎函式關閉對話框，必須提供掛鈎函式和應用程式之間的聯繫機理。

可以對公共對話框的標準控制臺進行子分類。但是公共對話框函式也可以對控制臺進行子分類。正因如此，必須在掛鈎函式函式WM_INTDIALDG訊息時對控制臺子分類。這就保證對話框函式設定子分類函式之前，子分類函式接收指定的控制訊息。

速查

Windows NT：3.1及以上版本；

Windows：95及以上版本；

windows CE：不支持；

頭檔案：commdlg.h；

庫檔案：用戶自定義。