FindWindowLike
Prev Chapter 9. Appendix - functions in alphabetical order Next

FindWindowLike

Finds the window handles of the windows matching the specified parameters and returns them as a list. You may specify the handle of the window to search under. The routine searches through all of this windows children and their children recursively. If 'undef' given, then the routine searches through all windows. There is also a regexp used to match against the text in the window caption and another regexp used to match against the text in the window class. If you pass a child ID number, the functions will only match windows with this id. In each case 'undef' matches everything.

@hwnd = FindWindowLike( $parent, $titleregex, $classregex, $childid, $maxlevel );

$parent

Handle of a window, which children we are looking for. If undefined, handle of the desktop is assumed

$titleregex

Regular expression used to match windows' caption. If not undef, only windows, which have caption matching with $titleregex will be returned. If undef, windows' caption is not considered during search

$classregex

Same as $titleregex but applies to window's class name

$childid

Control id of a child/children to be returned. If undef, $childid is not taken into consideration

$maxlevel

Maximum level in the window hierarchy tree for which child windows will be searched. Level 2 means that only direct children of $parent will be searched (which IMHO is misleading and should be changed)

Example 9.1. Getting all windows (apart from desktop)

    @hwnds = FindWindowLike();

Example 9.2. Finding calculator window

    @hwnds = FindWindowLike( undef, "^Calculator" );

Example 9.3. Finding a button of id=123, which is a direct child of the $parent

    @hwnds = FindWindowLike( $parent, undef, "Button", 123, 2 );
Prev Up Next
EnableWindow Home FreeVirtualBuffer