Función FindTextA (commdlg.h)

Artículo
11/20/2024

Crea un modelo definido por el sistema cuadro de diálogo Buscar que permite al usuario especificar una cadena para buscar y opciones que se usarán al buscar texto en un documento.

Sintaxis

HWND FindTextA(
  [in] LPFINDREPLACEA unnamedParam1
);

Parámetros

[in] 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 o para cerrar el cuadro de diálogo.

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. CommDlgExtendedError puede devolver uno de los siguientes códigos de error:

Observaciones

La función FindText no realiza una operación de búsqueda. 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 findText, 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 el botón Buscar siguiente o cuando se cierra el cuadro de diálogo. El parámetro lParam del FINDMSGSTRING contiene un puntero a una 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 Buscar, 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. isDialogMessage devuelve un valor que indica si el cuadro de diálogo Buscar procesó el mensaje.

Puede proporcionar un procedimiento de enlace de FRHookProc para un cuadro de diálogo buscar . 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 .

Ejemplos

Para obtener un ejemplo, vea buscar texto.

Nota

El encabezado commdlg.h define FindText 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)