FINDTEXTA Structure

The FINDTEXTA structure contains information used by the FindText and FindTextEx functions to search for a string within a specified rectangular area of a window. This structure is used with the ANSI version of the functions.

Syntax

typedef struct tagFINDTEXTA {
  HWND  hwnd;
  LPSTR lpstrText;
  LPSTR lpstrFindWhat;
  int   iMaxSearchLen;
} FINDTEXTA, *LPFINDTEXTA;

Members

Member Description
hwnd A handle to the window that contains the text to be searched.
lpstrText A pointer to a null-terminated string that contains the text to be searched.
lpstrFindWhat A pointer to a null-terminated string that specifies the text to search for.
iMaxSearchLen The maximum number of characters to search. If this member is -1, the function searches the entire text.

Remarks

The FindText function uses this structure to search for a specified string within a window. The search is confined to the rectangular area defined by the hwnd parameter.

The lpstrText member points to the text buffer where the search will occur. The lpstrFindWhat member points to the substring to find.

The iMaxSearchLen member limits the scope of the search. Setting it to -1 allows the search to encompass the entire text buffer pointed to by lpstrText.

See Also