ReplaceText

Funcția ReplaceText creează o casetă de dialog fără mod definite de sistem care permite utilizatorului specificați un șir pentru a căuta și un șir de înlocuire, precum și opțiuni pentru a controla găsi și înlocui opera?iunilor.

(HWND ReplaceText LPFINDREPLACE  lpfr / / indicatorul structura cu inițializare / / date);
 

Parametrii

lpfr
Indicator spre o structură FINDREPLACE care conține informații folosite pentru a initializa caseta de dialog. Caseta de dialog utilizează această structură a trimite informații despre utilizator intrare la cererea dumneavoastră. Pentru mai multe informații, consultați secțiunea observa?ii următoarele.

Valorile întroarse

Dacă funcția reușește, valoarea returnată este ghidajul ferestrei pentru a caseta de dialog. Utilizați ghidajul de fereastra pentru a comunica cu caseta de dialog sau închideți.

Dacă funcția nu reușește, valoarea returnată este NULL. Pentru a ob?ine informa?ii extinse despre erori, apela funcția de CommDlgExtendedError , care poate returna unul dintre următoarele coduri de eroare:

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOADRESFAILURE CDERR_NOHOOK
CDERR_LOADSTRFAILURE CDERR_NOTEMPLATE
CDERR_LOCKRESFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE FRERR_BUFFERLENGTHZERO

Observații

Funcția ReplaceText nu efectuează o operațiune de înlocuire text. În schimb, în caseta de dialog trimite mesaje FINDMSGSTRING înregistrate cu procedura de fereastra din fereastra proprietarul a casetei de dialog. Când se creează caseta de dialog, membru hwndOwner din structura FINDREPLACE identifică fereastra proprietar.

Înainte de asteptare ReplaceText, trebuie să apelați funcția RegisterWindowMessage pentru a obține identificatorul de mesaj FINDMSGSTRING. Procedura de caseta de dialog utilizează acest identificator pentru a trimite mesaje, atunci când utilizatorul face clic pe Căutare următor, înlocuire sau înlocui toate butoanele sau când se închide caseta de dialog. Parametrul lParam unui mesaj FINDMSGSTRING conține un indicator de structura FINDREPLACE . Membru steaguri de această structură indică evenimentul care a cauzat mesajul. Al?i membri ai structura indică utilizatorului intrare.

Dacă creați o casetă de dialog Înlocuire , trebuie, de asemenea, utilizați funcția IsDialogMessage în bucla mesajul principal al aplicației pentru a se asigura că în caseta de dialog corect procesele de input tastatură, cum ar fi tastele tab și esc. IsDialogMessage funcția întoarce o valoare care indică dacă caseta de dialog înlocuire prelucrate mesajul.

Furnizați o procedură de cârlig FRHookProc pentru o caseta de dialog Înlocuire . Procedura cârlig poate procesa mesajele trimise la caseta de dialog. Pentru a permite o procedură cârlig, setați pavilion FR_ENABLEHOOK membru steaguri de structura FINDREPLACE și specificați adresa procedura cârlig membru lpfnHook.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în commdlg.h.
Import Biblioteca:Utilizarea comdlg32.lib.
Unicode:Pus în aplicare ca Unicode și ANSI versiuni Windows NT.

A se vedea, de asemenea

Comune Dialog Box biblioteca prezentare generală, funcții comune de caseta de Dialog, CommDlgExtendedError, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG