DetectHiddenText

Determines whether invisible text in a window is "seen" for the purpose of finding the window. This affects windowing commands such as WinExist() and WinActivate.

DetectHiddenText, OnOff

Parameters

OnOff

Specify one of the following words:

On: Hidden text will be detected.

Off: Hidden text is not detected.

[v1.1.30+]: The decimal values 1 and 0 may be used in place of On and Off, respectively.

Remarks

If DetectHiddenText is not used, the default setting is On.

"Hidden text" is a term that refers to those controls of a window that are not visible. Their text is thus considered "hidden". Turning off DetectHiddenText can be useful in cases where you want to detect the difference between the different panes of a multi-pane window or multi-tabbed dialog. Use Window Spy to determine which text of the currently-active window is hidden. All commands, built-in functions and control flow statements that accept a WinText parameter are affected by this setting, including WinActivate, WinActive(), IfWinActive, WinWait, WinExist(), and IfWinExist.

The built-in variable A_DetectHiddenText contains the current setting (On or Off).

Every newly launched thread (such as a hotkey, custom menu item, or timed subroutine) starts off fresh with the default setting for this command. That default may be changed by using this command in the auto-execute section (top part of the script).

DetectHiddenWindows

Examples

Turns off the detection of hidden text.

DetectHiddenText, Off