Estructura FINDREPLACEW (commdlg.h)

Contiene información que las funciones de 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 de propietario de un Buscar o cuadro de diálogo Reemplazar.

Sintaxis

typedef struct tagFINDREPLACEW {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPWSTR       lpstrFindWhat;
  LPWSTR       lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCWSTR      lpTemplateName;
} FINDREPLACEW, *LPFINDREPLACEW;

Miembros

lStructSize

Tipo: DWORD de

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 de 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 FR_ENABLETEMPLATEHANDLE está establecida en el Flags, 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 de

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 FINDMSGSTRING mensaje registrado para indicar la entrada del usuario. Este miembro puede ser uno o varios de los siguientes valores.

lpstrFindWhat

Tipo: LPTSTR de

Cadena de búsqueda que el usuario ha escrito en el control Buscar editar. 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 editar. Si un mensaje de FINDMSGSTRING especifica la marca FR_FINDNEXT, lpstrFindWhat contiene la cadena que se va a buscar. Las marcas FR_DOWN, FR_WHOLEWORDy FR_MATCHCASE indican la dirección y el tipo de búsqueda. Si un mensaje de FINDMSGSTRING especifica las marcas FR_REPLACE o FR_REPLACE, lpstrFindWhat contiene la cadena que se va a reemplazar.

lpstrReplaceWith

Tipo: LPTSTR de

Cadena de reemplazo que el usuario ha escrito en el reemplazar por control de 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 editar.

Si un mensaje de 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 de 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 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, primero realice cualquier otra operación de pintura y, a continuación, llame a las funciones showWindow y UpdateWindow.

lpTemplateName

Tipo: LPCTSTR de

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 de cuadro de diálogo numerados, 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.

Observaciones

Requisitos

Consulte también

biblioteca de cuadros de diálogo común de

conceptual de

FRHookProc

findText

MAKEINTRESOURCE

de referencia de

replaceText

showWindow

WM_INITDIALOG