Core Function WinList

From Sputnik Wiki
(Difference between revisions)
Jump to: navigation, search
(Example)
(Return Value)
Line 19: Line 19:
 
=== Return Value ===
 
=== Return Value ===
  
Success: Returns an array of matching window titles and handles.
+
Success: Returns an array of matching windows.
  
Failure: Returns an empty array.  
+
Failure: Returns an empty array.
  
 
=== Remarks ===
 
=== Remarks ===

Revision as of 18:48, 19 August 2013

WinList ( <title>, <text> )

Contents

Description

Retrieves a list of windows.

Parameters

Title

The title of the window.

Text

Optional; The text of the window to read.

Return Value

Success: Returns an array of matching windows.

Failure: Returns an empty array.

Remarks

None.

See "WinTitleMatchMode" in Opt

Example

Opt( "WinDetectNoTitle", 0 ); // Do not check windows that have no title at all
Opt( "WinWaitDelay", 0 );
Opt( "WinSearchChildren", 0 ); // Only search top-level windows
 
$i = 0;
foreach ( WinList() as $pList )
{
	List( $Title, $HWND ) = $pList;
	If( IsWindowVisible($HWND) )
		println("Title '$Title' HWND '$HWND'");
}
 
Function IsWindowVisible($HWND)
{
	If ( WinGetState($HWND) & 2 )
		Return 1;
	Else
		Return 0;
}
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox