AppCtrlScript

AppCtrlScript	MAY Computer
Help

FINDWINDOWLIKE

Applies to
AppCtrlScript (Module: wmACScr1.dll)

Group
Other

See also
ACTIVATEWINDOW, FINDWINDOW, FINDTASK, CLOSEAPPS, KILLAPPS

Searches the window list for a window matching the parameters and stores the window handle of the first matching window or the handles of all found windows separated by ";" in a script variable.

Prefer this method rather than FINDWINDOW.

Syntax

FINDWIN[DOW]LIKE <VariableName>, <WindowText>[, <ClassName>][, <ReturnFirstOnly>][, <MaxDepth>]

Part

Description

<VariableName> Script variable where to store the found window handles.

<WindowText> Window title or text or part of it.

<ClassName> Window class name or part of it.

<ReturnFirstOnly> Optional; If True then returns only the first found matching window handle otherwise a list of windows. The default is True.

<MaxDepth> Optional maximum depth to search child windows; if 0 only windows that are directly childs of the desktop window are searched otherwise child windows are searched into the given maximum depth. 0 is the default. If you want to search not title only - for example for text in an open notepad then a depth of 5 is usually sufficient.

Applies to	AppCtrlScript (Module: wmACScr1.dll)
Group	Other
See also	ACTIVATEWINDOW, FINDWINDOW, FINDTASK, CLOSEAPPS, KILLAPPS

Part	Description
<VariableName>	Script variable where to store the found window handles.
<WindowText>	Window title or text or part of it.
<ClassName>	Window class name or part of it.
<ReturnFirstOnly>	Optional; If True then returns only the first found matching window handle otherwise a list of windows. The default is True.
<MaxDepth>	Optional maximum depth to search child windows; if 0 only windows that are directly childs of the desktop window are searched otherwise child windows are searched into the given maximum depth. 0 is the default. If you want to search not title only - for example for text in an open notepad then a depth of 5 is usually sufficient.