Estructura FINDREPLACEA (commdlg.h)

Artículo
08/22/2023

Contiene información que las funciones FindText y ReplaceText usan para inicializar los cuadros de diálogo Buscar y reemplazar . El mensaje registrado FINDMSGSTRING usa esta estructura para pasar la entrada de búsqueda o reemplazo del usuario a la ventana propietaria de un cuadro de diálogo Buscar o Reemplazar .

Sintaxis

typedef struct tagFINDREPLACEA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPSTR        lpstrFindWhat;
  LPSTR        lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;

Miembros

lStructSize

Tipo: DWORD

Longitud, en bytes, de la estructura.

hwndOwner

Tipo: HWND

Identificador de la ventana que posee el cuadro de diálogo. El procedimiento de ventana de la ventana especificada recibe mensajes FINDMSGSTRING del cuadro de diálogo. Este miembro puede ser cualquier identificador de ventana válido, pero no debe ser NULL.

hInstance

Tipo: HINSTANCE

Si la marca de FR_ENABLETEMPLATEHANDLE está establecida en Marcas, hInstance es un identificador de un objeto de memoria que contiene una plantilla de cuadro de diálogo. Si se establece la marca FR_ENABLETEMPLATE , hInstance es un identificador de un módulo que contiene una plantilla de cuadro de diálogo denominada por el miembro lpTemplateName . Si no se establece ninguna marca, se omite este miembro.

Flags

Tipo: DWORD

Un conjunto de marcas de bits que puede usar para inicializar el cuadro de diálogo. El cuadro de diálogo establece estas marcas cuando envía el mensaje registrado FINDMSGSTRING para indicar la entrada del usuario. Este miembro puede ser uno o varios de los valores siguientes.

Valor	Significado
FR_DIALOGTERM 0x00000040	Si se establece en un mensaje FINDMSGSTRING , indica que el cuadro de diálogo se está cerrando. Cuando recibe un mensaje con este conjunto de marcas, el identificador del cuadro de diálogo devuelto por la función FindText o ReplaceText ya no es válido.
FR_DOWN 0x00000001	Si se establece, se selecciona el botón Abajo de los botones de radio de dirección en un cuadro de diálogo Buscar que indica que debe buscar desde la ubicación actual hasta el final del documento. Si no se establece, se selecciona el botón Subir , por lo que debe buscar en el principio del documento. Puede establecer esta marca para inicializar el cuadro de diálogo. Si se establece en un mensaje FINDMSGSTRING , indica la selección del usuario.
FR_ENABLEHOOK 0x00000100	Habilita la función de enlace especificada en el miembro lpfnHook . Esta marca solo se usa para inicializar el cuadro de diálogo.
FR_ENABLETEMPLATE 0x00000200	Indica que los miembros hInstance y lpTemplateName especifican una plantilla de cuadro de diálogo que se va a usar en lugar de la plantilla predeterminada. Esta marca solo se usa para inicializar el cuadro de diálogo.
FR_ENABLETEMPLATEHANDLE 0x00002000	Indica que el miembro hInstance identifica un bloque de datos que contiene una plantilla de cuadro de diálogo precargada. El sistema omite el miembro lpTemplateName si se especifica esta marca.
FR_FINDNEXT 0x00000008	Si se establece en un mensaje FINDMSGSTRING , indica que el usuario ha realizado clic en el botón Buscar siguiente en un cuadro de diálogo Buscar o reemplazar . El miembro lpstrFindWhat especifica la cadena que se va a buscar.
FR_HIDEUPDOWN 0x00004000	Si se establece al inicializar un cuadro de diálogo Buscar , oculta los botones de radio de dirección de búsqueda.
FR_HIDEMATCHCASE 0x00008000	Si se establece al inicializar un cuadro de diálogo Buscar o Reemplazar , oculta la casilla Coincidir mayúsculas y minúsculas.
FR_HIDEWHOLEWORD 0x00010000	Si se establece al inicializar un cuadro de diálogo Buscar o Reemplazar, oculta la casilla Coincidir todo Word solo.
FR_MATCHCASE 0x00000004	Si se establece, la casilla Coincidir mayúsculas y minúsculas está activada que indica que la búsqueda debe distinguir mayúsculas de minúsculas. Si no se establece, la casilla no está seleccionada, por lo que la búsqueda debe no distinguir mayúsculas de minúsculas. Puede establecer esta marca para inicializar el cuadro de diálogo. Si se establece en un mensaje FINDMSGSTRING , indica la selección del usuario.
FR_NOMATCHCASE 0x00000800	Si se establece al inicializar un cuadro de diálogo Buscar o Reemplazar , deshabilita la casilla Coincidir mayúsculas y minúsculas.
FR_NOUPDOWN 0x00000400	Si se establece al inicializar un cuadro de diálogo Buscar , deshabilita los botones de radio de dirección de búsqueda.
FR_NOWHOLEWORD 0x00001000	Si se establece al inicializar un cuadro de diálogo Buscar o Reemplazar, deshabilita la casilla De Word completa.
FR_REPLACE 0x00000010	Si se establece en un mensaje FINDMSGSTRING , indica que el usuario ha realizado clic en el botón Reemplazar en un cuadro de diálogo Reemplazar . El miembro lpstrFindWhat especifica la cadena que se va a reemplazar y el miembro lpstrReplaceWith especifica la cadena de reemplazo.
FR_REPLACEALL 0x00000020	Si se establece en un mensaje FINDMSGSTRING , indica que el usuario ha realizado clic en el botón Reemplazar todo en un cuadro de diálogo Reemplazar . El miembro lpstrFindWhat especifica la cadena que se va a reemplazar y el miembro lpstrReplaceWith especifica la cadena de reemplazo.
FR_SHOWHELP 0x00000080	Hace que el cuadro de diálogo muestre el botón Ayuda . El miembro hwndOwner debe especificar la ventana para recibir los mensajes registrados HELPMSGSTRING que envía el cuadro de diálogo cuando el usuario hace clic en el botón Ayuda .
FR_WHOLEWORD 0x00000002	Si se establece, la casilla Coincidir todo Word solo está activada, lo que indica que solo debe buscar palabras completas que coincidan con la cadena de búsqueda. Si no se establece, la casilla no está seleccionada, por lo que también debe buscar fragmentos de palabras que coincidan con la cadena de búsqueda. Puede establecer esta marca para inicializar el cuadro de diálogo. Si se establece en un mensaje FINDMSGSTRING , indica la selección del usuario.

lpstrFindWhat

Tipo: LPTSTR

Cadena de búsqueda que el usuario ha escrito en el control Buscar qué edición. Debe asignar dinámicamente el búfer o usar una matriz global o estática para que no salga del ámbito antes de que se cierre el cuadro de diálogo. El búfer debe tener al menos 80 caracteres de longitud. Si el búfer contiene una cadena al inicializar el cuadro de diálogo, la cadena se muestra en el control Buscar qué edición. Si un mensaje FINDMSGSTRING especifica la marca de FR_FINDNEXT , lpstrFindWhat contiene la cadena que se va a buscar. Las marcas FR_DOWN, FR_WHOLEWORD y FR_MATCHCASE indican la dirección y el tipo de búsqueda. Si un mensaje FINDMSGSTRING especifica las marcas FR_REPLACE o FR_REPLACE , lpstrFindWhat contiene la cadena que se va a reemplazar.

lpstrReplaceWith

Tipo: LPTSTR

Cadena de reemplazo que el usuario ha escrito en el control Reemplazar por edición. Debe asignar dinámicamente el búfer o usar una matriz global o estática para que no salga del ámbito antes de que se cierre el cuadro de diálogo. Si el búfer contiene una cadena al inicializar el cuadro de diálogo, la cadena se muestra en el control Reemplazar por edición.

Si un mensaje FINDMSGSTRING especifica las marcas FR_REPLACE o FR_REPLACEALL , lpstrReplaceWith contiene la cadena de reemplazo .

La función FindText omite este miembro.

wFindWhatLen

Tipo: WORD

Longitud, en bytes, del búfer al que apunta el miembro lpstrFindWhat .

wReplaceWithLen

Tipo: WORD

Longitud, en bytes, del búfer al que apunta el miembro lpstrReplaceWith .

lCustData

Tipo: LPARAM

Datos definidos por la aplicación que el sistema pasa al procedimiento de enlace identificado por el miembro lpfnHook . Cuando el sistema envía el mensaje WM_INITDIALOG al procedimiento de enlace, el parámetro lParam del mensaje es un puntero a la estructura FINDREPLACE especificada cuando se creó el cuadro de diálogo. El procedimiento de enlace puede usar este puntero para obtener el valor lCustData .

lpfnHook

Tipo: LPFRHOOKPROC

Puntero a un procedimiento de enlace FRHookProc que puede procesar mensajes destinados al cuadro de diálogo. Este miembro se omite a menos que la marca de FR_ENABLEHOOK esté establecida en el miembro Flags . Si el procedimiento de enlace devuelve FALSE en respuesta al mensaje de WM_INITDIALOG , el procedimiento de enlace debe mostrar el cuadro de diálogo o, de lo contrario, no se mostrará el cuadro de diálogo. Para ello, realice primero cualquier otra operación de pintura y, a continuación, llame a las funciones ShowWindow y UpdateWindow .

lpTemplateName

Tipo: LPCTSTR

Nombre del recurso de plantilla del cuadro de diálogo en el módulo identificado por el miembro hInstance . Esta plantilla se sustituye por la plantilla de cuadro de diálogo estándar. Para los recursos numerados del cuadro de diálogo, puede ser un valor devuelto por la macro MAKEINTRESOURCE . Este miembro se omite a menos que la marca FR_ENABLETEMPLATE esté establecida en el miembro Flags .

Comentarios

Nota

El encabezado commdlg.h define FINDREPLACE 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]
Encabezado	commdlg.h (incluye Windows.h)