Función ReplaceTextA (commdlg.h)

Artículo
08/22/2023

Crea un cuadro de diálogo modelado definido por el sistema que permite al usuario especificar una cadena para buscar y una cadena de reemplazo, así como opciones para controlar las operaciones de búsqueda y reemplazo.

Sintaxis

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

Parámetros

[in, out] unnamedParam1

Tipo: LPFINDREPLACE

Puntero a una estructura FINDREPLACE que contiene información utilizada para inicializar el cuadro de diálogo. El cuadro de diálogo usa esta estructura para enviar información sobre la entrada del usuario a la aplicación. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

Tipo: HWND

Si la función se ejecuta correctamente, el valor devuelto es el identificador de ventana del cuadro de diálogo. Puede usar el identificador de ventana para comunicarse con el cuadro de diálogo o cerrarlo.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a la función CommDlgExtendedError , que puede devolver uno de los siguientes códigos de error:

Comentarios

La función ReplaceText no realiza una operación de reemplazo de texto. En su lugar, el cuadro de diálogo envía mensajes registrados FINDMSGSTRING al procedimiento de ventana de la ventana propietaria del cuadro de diálogo. Al crear el cuadro de diálogo, el miembro hwndOwner de la estructura FINDREPLACE es un identificador para la ventana del propietario.

Antes de llamar a ReplaceText, debe llamar a la función RegisterWindowMessage para obtener el identificador del mensaje FINDMSGSTRING . El procedimiento del cuadro de diálogo usa este identificador para enviar mensajes cuando el usuario hace clic en los botones Buscar siguiente, Reemplazar o Reemplazar todo , o cuando se cierra el cuadro de diálogo. El parámetro lParam de un mensaje FINDMSGSTRING contiene un puntero a la estructura FINDREPLACE . El miembro Flags de esta estructura indica el evento que provocó el mensaje. Otros miembros de la estructura indican la entrada del usuario.

Si crea un cuadro de diálogo Reemplazar , también debe usar la función IsDialogMessage en el bucle de mensajes principal de la aplicación para asegurarse de que el cuadro de diálogo procesa correctamente la entrada del teclado, como las teclas TAB y ESC. La función IsDialogMessage devuelve un valor que indica si el cuadro de diálogo Reemplazar procesó el mensaje.

Puede proporcionar un procedimiento de enlace FRHookProc para un cuadro de diálogo Reemplazar . El procedimiento de enlace puede procesar los mensajes enviados al cuadro de diálogo. Para habilitar un procedimiento de enlace, establezca la marca FR_ENABLEHOOK en el miembro Flags de la estructura FINDREPLACE y especifique la dirección del procedimiento de enlace en el miembro lpfnHook .

Nota

El encabezado commdlg.h define ReplaceText como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commdlg.h (incluye Windows.h)
Library	Comdlg32.lib
Archivo DLL	Comdlg32.dll
Conjunto de API	ext-ms-win-shell-comdlg32-l1-1-1 (introducido en Windows 10, versión 10.0.14393)