Revision history [back]

WindowToScreen() helper function can be utilized with FindText() by converting the coordinates of the rectangle parameter of FindText() function from the client area of the window to the screen coordinates using the WindowToScreen() function. This ensures that the FindText() function searches for the text in the correct location on the screen. Here is an example:

HWND hWnd = GetForegroundWindow(); // get handle to the active window
RECT rect = { 10, 10, 100, 100 }; // set the rectangle coordinates in the client area of hWnd

// convert the coordinates to screen coordinates
ClientToScreen(hWnd, (LPPOINT)&rect.left);
ClientToScreen(hWnd, (LPPOINT)&rect.right);

// search for the text in the converted coordinates
HWND hFound = FindText(hWnd, NULL, NULL, TEXT("example"), &rect);

if (hFound != NULL)
{
    // text was found at the specified location
}
else
{
    // text was not found at the specified location
}

In this example, the client coordinates of the rectangle parameter are converted to screen coordinates using the ClientToScreen() function. The resulting rectangle is then passed to the FindText() function to search for the text "example" in the specified area on the screen. If the text is found, the function returns the handle to the matching window; otherwise, it returns NULL.