Función ReplaceTextA (commdlg.h)

Artículo
11/20/2024

Crea un cuadro de diálogo modeless 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 siguiente sección Comentarios.

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 se produce un error en la función, 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:

Observaciones

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

Antes de llamar a ReplaceText, debe llamar a la función RegisterWindowMessage para obtener el identificador del mensaje de FINDMSGSTRING . El procedimiento del cuadro de diálogo usa este identificador para enviar mensajes cuando el usuario hace clic en el Buscar siguiente, Reemplazaro reemplazar todos los botones de 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 de 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 Flags miembro del FINDREPLACE estructura y especifique la dirección del procedimiento de enlace en el miembro lpfnHook .

Nota

El encabezado commdlg.h define ReplaceText como 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commdlg.h (incluya Windows.h)
biblioteca de	Comdlg32.lib
DLL de	Comdlg32.dll
conjunto de API de	ext-ms-win-shell-comdlg32-l1-1-1 (introducido en Windows 10, versión 10.0.14393)