Funzione ReplaceTextA (commdlg.h)

Articolo
11/20/2024

Crea una finestra di dialogo senza modalità definita dal sistema che consente all'utente di specificare una stringa da 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 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 la finestra di dialogo o chiuderla.

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

Osservazioni

La funzione ReplaceText non esegue un'operazione di sostituzione del testo. 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 ReplaceText, è necessario chiamare la funzione RegisterWindowMessage per ottenere l'identificatore per il messaggio FINDMSGSTRING. La routine della finestra di dialogo usa questo identificatore per inviare messaggi quando l'utente fa clic sul pulsante Trova successivo, Sostituiscio Sostituisci tutto oppure quando la finestra di dialogo viene chiusa. Il parametro lParam di un messaggio di FINDMSGSTRING contiene un puntatore alla 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 Sostituisci, è 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. La funzione IsDialogMessage restituisce un valore che indica se la finestra di dialogo Sostituisci ha elaborato il messaggio.

È possibile fornire una FRHookProc routine hook per una finestra di dialogo Sostituisci. 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 .

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 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)