Funzione FindTextA (commdlg.h)

Articolo
11/20/2024

Crea una finestra di dialogo trova definita dal sistema che consente all'utente di specificare una stringa per cercare e opzioni da utilizzare durante la ricerca di testo in un documento.

Sintassi

HWND FindTextA(
  [in] LPFINDREPLACEA unnamedParam1
);

Parametri

[in] unnamedParam1

Tipo: LPFINDREPLACE

Puntatore a una struttura FINDREPLACE che contiene informazioni utilizzate per inizializzare la finestra di dialogo. La finestra di dialogo usa questa struttura per inviare informazioni sull'input dell'utente all'applicazione. Per altre informazioni, vedere la sezione Osservazioni seguente.

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è l'handle di finestra nella finestra di dialogo. È possibile usare 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 estese sull'errore, chiamare la funzione CommDlgExtendedError. CommDlgExtendedError può restituire uno dei codici di errore seguenti:

Osservazioni

La funzione FindText non esegue un'operazione di ricerca. La finestra di dialogo invia invece FINDMSGSTRING messaggi registrati alla procedura di finestra del proprietario della finestra di dialogo. Quando si crea la finestra di dialogo, il membro hwndOwner della struttura FINDREPLACE è un handle per la finestra del proprietario.

Prima di chiamare FindText, è necessario chiamare la funzione RegisterWindowMessage per ottenere l'identificatore per il messaggio FINDMSGSTRING. La procedura della finestra di dialogo utilizza questo identificatore per inviare messaggi quando l'utente fa clic sul pulsante Trova successivo oppure quando la finestra di dialogo viene chiusa. Il parametro lParam del messaggio FINDMSGSTRING contiene un puntatore a una struttura FINDREPLACE. Il Flag membro di questa struttura indica l'evento che ha causato il messaggio. Altri membri della struttura indicano l'input dell'utente.

Se si crea un finestra di dialogo Trova, è necessario usare anche la funzione IsDialogMessage nel ciclo di messaggi principale dell'applicazione per assicurarsi che la finestra di dialogo elabori correttamente l'input della tastiera, ad esempio i tasti TAB e ESC. IsDialogMessage restituisce un valore che indica se la finestra di dialogo Trova ha elaborato il messaggio.

È possibile specificare una procedura hook FRHookProc per una finestra di dialogo trova . La procedura hook può elaborare i messaggi inviati alla finestra di dialogo. Per abilitare una routine hook, impostare il flag di FR_ENABLEHOOK nel membro flag della struttura FINDREPLACE e specificare l'indirizzo della routine hook nel membro lpfnHook .

Esempi

Per un esempio, vedere ricerca di testo.

Nota

L'intestazione commdlg.h definisce FindText come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	commdlg.h (include Windows.h)
libreria	Comdlg32.lib
dll	Comdlg32.dll
set di API	ext-ms-win-shell-comdlg32-l1-1-1 (introdotto in Windows 10, versione 10.0.14393)