基本介紹
- 中文名：ReplaceText
- 函式原型：HWND ReplaceText
- 函式功能：執行控制和替代操作
- 備註：不執行文本替代操作
參數,備註,速查,
參數
Ipfr：指向一個包含初始化對話框的信息的FINDREPLACE結構。對話框套用此結構把用戶輸入的有關信息傳送到應用程式。有關更多的信息，見卜列說明部分。
返回值：如果函式調用成功，返回值為對話框的視窗句柄，可以用視窗句柄與對話框聯繫或關閉它。如果函式調用失敗，返回值為NULL。若想獲得更多的錯誤信息，調用CommDlgExError函式，其返回值如下：
CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION COERR_NOHINSTANCE
CDERR_LOADRESFAILURE CDERR_NOHOOK
CDERR_LOADSTRFAILURE CDERR_BITEMPLATE
CDERR_LOCKRESFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE FRERR_BUFFERLENGTHZERO
備註
PepIACEText函式不執行文本替代操作。相反，對話框把FINDSGSTRING 已登記的信息傳送到對話框視窗的視窗函式。當創建對話框時，FINDREPLACE結構的hwndowner成員指定該對話框視窗。
調用ReplaceText函式之前，必須調用RegisterWindowMessage函式為FINDSGSTRING信息登記標識。
當用戶擊點Find Next，Replace ALL按鈕時，或當關閉對話框時，對話框函式套用這些標識傳送信息。
FINDMSGSTRING信息中的IParam參數含有一個指向FINDREPLACE結構的指針。此結構的Flags成員表明了形式信息的事件。該結構中其他的成員表明用戶的輸入信息。
如果創建了Replace對話框，必須套用應用程式信息鏈中的IsDialogMesssage函式來保證對話框能正確處理鏈盤輸入信息，例如Tab鍵和Esc鍵。
ISDialogMessage函式返回值表明Replace對話框是否處理信息。
可以為Replace對話樞提供一個FRHookProc掛鈎函式，此掛鈎函式能處理髮送到對話框中的信息。
為使一個掛鈎函式生效，可設定FINDREPLACE結構中Flags成員的FR_ENABLEHOOK標誌且指定IpfnHook成員中掛鈎函式的地址。
速查
Windows NT：3.1及以上版本；
Windows：95及以上版本；
Windows CE：不支持；
頭檔案：commdlg.h；
庫檔案：comdlg32.lib；
註：在Windows NT環境中實現為Unicode和ANSI兩個版本。
