La funzione trova testo crea un modali definite dal sistema nella finestra di dialogo trova che consente all'utente di specificare una stringa da cercare e opzioni da utilizzare quando si eseguono ricerche per testo in un documento.
(HWND FindText LPFINDREPLACE lpfr / / puntatore alla struttura con l'inizializzazione / / dati);
Se la funzione ha esito positivo, il valore restituito è l'handle di finestra di dialogo. È possibile utilizzare l'handle di finestra per comunicare con o per chiudere la finestra di dialogo.
Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni di errore estese, chiamare la funzione CommDlgExtendedError . CommDlgExtendedError può restituire uno dei seguenti codici di errore:
| CDERR_FINDRESFAILURE | CDERR_MEMLOCKFAILURE |
| CDERR_INITIALIZATION | CDERR_NOHINSTANCE |
| CDERR_LOCKRESFAILURE | CDERR_NOHOOK |
| CDERR_LOADRESFAILURE | CDERR_NOTEMPLATE |
| CDERR_LOADSTRFAILURE | CDERR_STRUCTSIZE |
| CDERR_MEMALLOCFAILURE | FRERR_BUFFERLENGTHZERO |
La funzione trova testo non esegue un'operazione di ricerca. Invece, nella finestra di dialogo Invia messaggi FINDMSGSTRING registrato a routine di finestra del finestra proprietaria della finestra di dialogo. Quando si crea la finestra di dialogo, il hwndOwner membro della struttura FINDREPLACE identifica la finestra proprietaria.
Prima di chiamare FindText, è necessario chiamare la funzione RegisterWindowMessage per ottenere l'identificatore per il messaggio FINDMSGSTRING. La procedura di casella di dialogo utilizza questo identificatore per inviare messaggi, quando l'utente sceglie il pulsanteavanti e trovare, o quando si sta chiudendo la finestra di dialogo. Il parametro lParam del messaggio FINDMSGSTRING contiene un puntatore a una struttura FINDREPLACE . Membro di questa struttura flag indica l'evento che ha causato il messaggio. Altri membri della struttura indicano l'input dell'utente .
Se si crea una finestra di dialogo trova , è necessario utilizzare anche la funzione di IsDialogMessage nel ciclo di messaggi principale della vostra applicazione per garantire che la finestra di dialogo correttamente elabora input da tastiera, come ad esempio i tasti tab ed esc. IsDialogMessage restituisce un valore che indica se la finestra di dialogo trova elaborato il messaggio.
È possibile fornire una routine di hook FRHookProc per una finestra di dialogo trova . La routine di hook in grado di elaborare i messaggi inviati a una finestra di dialogo. Per attivare una procedura di gancio, impostare il flag FR_ENABLEHOOK nel membro Flags della struttura FINDREPLACE e specificare l'indirizzo della procedura gancio nel membro lpfnHook.
nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in commdlg.h.
Importare librerie:Utilizzare comdlg32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.
Comune di dialogo casella libreria panoramica, funzioni di Box di dialogo comuni, CommDlgExtendedError, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText
Rimedio: Inserire il CD-ROM CD di MSDN Library.