Function GetValidLastUsedWindow

source/window.cpp:641–658

HWND GetValidLastUsedWindow(global_struct &aSettings)
// If the last found window is one of the script's own GUI windows, it is considered valid even if
// DetectHiddenWindows is ON.  Note that this exemption does not apply to things like "IfWinExist,
// My Gui Title", "WinActivate, ahk_id <gui id>", etc.
// A GUI window can become the last found window while DetectHiddenWindows is ON in two ways:
// Gui +LastFound
// The launch of a GUI thread that explicitly set the last found window to be that GUI window.
{
	if (!aSettings.hWndLastUsed || !IsWindow(aSettings.hWndLastUsed))
		return NULL;
	if (   aSettings.DetectWindow(aSettings.hWndLastUsed)
		|| (GetWindowLong(aSettings.hWndLastUsed, GWL_STYLE) & WS_CHILD)   ) // v1.0.40.05: Child windows (via ahk_id) are always detectible.
		return aSettings.hWndLastUsed;
	// Otherwise, DetectHiddenWindows is OFF and the window is not visible.  Return NULL
	// unless this is a GUI window belonging to this particular script, in which case
	// the setting of DetectHiddenWindows is ignored (as of v1.0.25.13).
	return GuiType::FindGui(aSettings.hWndLastUsed) ? aSettings.hWndLastUsed : NULL;
}