FindText

Funcţia FindText creează un model definit de sistem de Căutare caseta de dialog care permite utilizatorului specificaţi un şir de căutare pentru şi opţiuni pentru a utiliza atunci când caută pentru text într-un document.

(HWND FindText 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 sau pentru a închide caseta de dialog.

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

Observaţii

Funcţia FindText nu efectuează o operaţiune de căutare. Î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 FindText, 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 butonulUrmătorul găsit, sau când se închide caseta de dialog. Parametrul lParam FINDMSGSTRING mesajului conţine un indicator spre o structură 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 de Căutare , 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 returnează o valoare care indică dacă caseta de dialog Găsire prelucrate mesajul.

Furnizaţi o procedură de cârlig FRHookProc pentru o casetă de dialog Căutare . 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, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText

Index