FindText

FindText

FindText所屬函式,該函式創建一個系統定義的無模式Find對話框,為使用戶指定一個串來查找文本內的文字。

函式功能

函式創建一個系統定義的無模式Find對話框,為使用戶指定一個串來查找文本內的文字。
函式原型:HWND FindText(LPFINDREPLACE lpfr);
參數FindText
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結構中的hwndCwner成員標識視窗。
調用Find Text函式前,必須調用RegisterWindowMessage函式以得到FINDMSGSTRING信息的標識符,對話框函式在用戶點擊FindNext按鈕或對話框被關閉時利用此標識符傳送信息。FINDMSGSTRING信息的IParam參數包含一個指向FINDREPLACE結構的指針,此結構的Flags成員顯示開誠信息的事件。
其他成員顯示用戶的輸入。FindText
若想創建對話框,必須利用應用程式的主信息鏈中的IsDialogMessage函式來保證對話框正確處理鍵盤輸入,例如Tab和Esc鍵。IsDialogMessage返回值顯示Find對話框是否處理信息。
可以為Find對話框提供一個掛鈎函式FRHookProc。掛鈎函式可處理髮送到對話框中的信息。為使掛鈎函式生效,可設定HNDREPLACE結構的Flags成員的FR_ENABLEHOOK標誌,且指定IpfnHook成員中掛鈎函式的地址。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:commdlg.h;庫檔案:comdlg32.lib;Unicode:在Windows NT環境中實現為Unicode和ANSI兩個版本。

相關詞條

相關搜尋

熱門詞條

聯絡我們