FindText是計算機函式，用於創建一個系統定義的無模式Find對話框，為使用戶指定一個串來查找文本內的文字。
基本介紹
- 中文名：FindText
- 速查：Windows
- Windows：95及以上版本
- NT：3.1及以上版本
函式功能,函式原型,參數,備註,
函式功能
該函式創建一個系統定義的無模式Find對話框，為使用戶指定一個串來查找文本內的文字。
函式原型
HWND FindText（LPFINDREPLACE lpfr）；
參數
Ipfr：指向一個FINDEPLACE結構，此結構包含用來初始對話框的信息。對話框用此結構把用戶輸入的信息傳送到應用程式。有關更多的信息，請參見下面說明部分。
返回值：如果函式調用成功，返回值是對話框的視窗句柄。可以使用視窗句柄與對話框聯繫或關閉它；如果函式調用失敗，返回值為NULL。若想獲得更多的錯誤信息，請調用CommDlgExtendedError函式。其返回值如下：
CDERR_FINDRESFAILURE；CDERR_MEMLOCKFAILURE；CDERR_INITIALIZATION
CDERR_NOHINSTANCE；CDERR_LOCKRESFAILURE；CDERR_NOHOOK
CDERR_LOADRESFAILURE；CDERR_NOTEMPLATE；CDERR_LOADSTRFAILURE
CDERR_STRUCTSIZE；CDERR_MEMALLOCFAILURE；FRERR_BUFFERLENGTHZERO
備註
FindText函式不執行查找操作，相反，對話框把FINDMSGSTRING己登記的信息傳送到對話框視窗的視窗過程。當創建對話框時FINDReplace結構中的hwndOwner成員是視窗句柄。
調用Find Text函式前，必須調用RegisterWindowMessage函式以得到FINDMSGSTRING信息的標識符，對話框函式在用戶點擊FindNext按鈕或對話框被關閉時利用此標識符傳送信息。FINDMSGSTRING信息的IParam參數包含一個指向FINDREPLACE結構的指針，此結構的Flags成員顯示引起信息的事件，而結構其它成員則指明了用戶輸入的數據。
若想創建對話框，必須利用應用程式的主信息鏈中的IsDialogMessage函式來保證對話框正確處理鍵盤輸入，例如Tab和Esc鍵。IsDialogMessage返回值顯示Find對話框是否處理信息。
可以為Find對話框提供一個掛鈎函式FRHookProc。掛鈎函式可處理髮送到對話框中的信息。為使掛鈎函式生效，可設定HNDREPLACE結構的Flags成員的FR_ENABLEHOOK標誌，且指定IpfnHook成員中掛鈎函式的地址。
