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兩個版本。