Función FindTextA (commdlg.h)

Artículo
02/26/2024

Crea un cuadro de diálogo Buscar modelo definido por el sistema 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 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 o para cerrar el cuadro de diálogo.

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

Comentarios

La función FindText no realiza una operación de búsqueda. 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 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 mensaje 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 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 miembro Flags de la estructura FINDREPLACE 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 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)