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:

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

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