Funzione ReplaceTextA (commdlg.h)

Articolo
02/24/2024

Crea una finestra di dialogo senza modalità definita dal sistema che consente all'utente di specificare una stringa per cercare e una stringa di sostituzione, nonché opzioni per controllare le operazioni di ricerca e sostituzione.

Sintassi

HWND ReplaceTextA(
  [in, out] LPFINDREPLACEA unnamedParam1
);

Parametri

[in, out] unnamedParam1

Tipo: LPFINDREPLACE

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

Valore restituito

Tipo: HWND

Se la funzione ha esito positivo, il valore restituito è l'handle della finestra nella finestra di dialogo. È possibile usare l'handle della finestra per comunicare con la finestra di dialogo o chiuderla.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni sull'errore estese, chiamare la funzione CommDlgExtendedError , che può restituire uno dei codici di errore seguenti:

Commenti

La funzione ReplaceText non esegue un'operazione di sostituzione del testo. La finestra di dialogo invia invece messaggi registrati FINDMSGSTRING 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 nella finestra del proprietario.

Prima di chiamare ReplaceText, è necessario chiamare la funzione RegisterWindowMessage per ottenere l'identificatore per il messaggio FINDMSGSTRING . La procedura della finestra di dialogo usa questo identificatore per inviare messaggi quando l'utente fa clic sui pulsanti Trova avanti, Sostituisci o Sostituisci tutti oppure quando la finestra di dialogo viene chiusa. Il parametro lParam di un messaggio FINDMSGSTRING contiene un puntatore alla struttura FINDREPLACE . Il membro Flag di questa struttura indica l'evento che ha causato il messaggio. Altri membri della struttura indicano l'input dell'utente.

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

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

Nota

L'intestazione commdlg.h definisce ReplaceText come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commdlg.h (includere Windows.h)
Libreria	Comdlg32.lib
DLL	Comdlg32.dll
Set di API	ext-ms-win-shell-comdlg32-l1-1-1 (introdotta in Windows 10, versione 10.0.14393)