Win32 API Reference

FINDTEXTW Structure

The FINDTEXTW structure contains information used by the FindText function to search for text within a dialog box.

typedef struct tagFINDTEXTW {
  RECT    *lprc;
  LPWSTR  lpstrText;
  LPWSTR  lpstrSel;
  int     chars;
  DWORD   flags;
} FINDTEXTW, *LPFINDTEXTW;
            

Members

• lprc RECT *
  A pointer to a RECT structure that specifies the bounding rectangle of the search area. If this member is NULL, the search is performed within the entire dialog box.
• lpstrText LPWSTR
  A pointer to a null-terminated Unicode string that contains the text to search for.
• lpstrSel LPWSTR
  A pointer to a buffer that receives the selected text. This member can be NULL. If it is not NULL, the function copies the selected text into this buffer.
• chars int
  The number of characters available in the lpstrSel buffer. This member is not used if lpstrSel is NULL.
• flags DWORD
  Search options. This member can be zero or a combination of the following values:

  • FR_DOWN: Searches forward from the current position.
  • FR_WHOLEWORD: Searches for whole words only.
  • FR_MATCHCASE: Performs a case-sensitive search.

Syntax Example

// Example of how to initialize a FINDTEXTW structure
FINDTEXTW findInfo;
RECT searchRect = {10, 10, 200, 100}; // Define search area
WCHAR searchString[] = L"example text";
WCHAR selectionBuffer[100];

findInfo.lprc = &searchRect;
findInfo.lpstrText = searchString;
findInfo.lpstrSel = selectionBuffer;
findInfo.chars = 100;
findInfo.flags = FR_DOWN | FR_WHOLEWORD;

// Assuming hDialog is a handle to your dialog box
HWND hDialog = GetActiveWindow(); // Or obtain your dialog handle

LRESULT result = SendMessage(hDialog, WM_FINDTEXT, 0, (LPARAM)&findInfo);

if (result != -1) {
    // Text found or selection updated
    if (findInfo.lpstrSel[0] != L'\0') {
        // Selected text is in findInfo.lpstrSel
    }
} else {
    // Error or text not found
}
            

See Also

• FindText Function
• RECT Structure

Remarks