Core Function WinGetHandle - Revision history

UberFoX: 1 revision

2015-06-14T12:38:31Z

1 revision

← Older revision

Revision as of 12:38, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:34Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX: /* Return Value */

2013-08-25T22:54:11Z

Return Value

← Older revision		Revision as of 22:54, 25 August 2013
Line 19:		Line 19:
	=== Return Value ===		=== Return Value ===

−	Success: ~~Returns a string containing the~~ window handle value.	+	Success: The window handle value.

−	Failure: ~~Returns "" (blank string)~~.	+	Failure: @PTRZero.

	=== Remarks ===		=== Remarks ===

UberFoX: /* Example */

2013-08-19T18:25:34Z

Example

← Older revision		Revision as of 18:25, 19 August 2013
Line 38:		Line 38:
	Opt("WinTitleMatchMode", 4);		Opt("WinTitleMatchMode", 4);
	// Get the handle of a notepad window that contains "this one"		// Get the handle of a notepad window that contains "this one"
−	$handle = WinGetHandle("~~classname~~=Notepad", "this one");	+	$handle = WinGetHandle("[class=Notepad]", "this one");
	If ( $handle )		If ( $handle )
	{		{

UberFoX: Created page with "

 WinGetHandle ( , <text> )  </pre>  === Description ===  Retrieves the internal handle of a window.  === Parameters ===  ==== Title ====  The title of the window.  ==..."</h1>
<p>2011-11-27T01:48:40Z</p>
<p>Created page with "<pre> WinGetHandle ( <title>, <text> )  </pre>  === Description ===  Retrieves the internal handle of a window.  === Parameters ===  ==== Title ====  The title of the window.  ==..."</p>
<p><b>New page</b></p><div><pre><br />
WinGetHandle ( <title>, <text> ) <br />
</pre><br />
<br />
=== Description ===<br />
<br />
Retrieves the internal handle of a window.<br />
<br />
=== Parameters ===<br />
<br />
==== Title ====<br />
<br />
The title of the window.<br />
<br />
==== Text ====<br />
<br />
Optional; The text of the window to read.<br />
<br />
=== Return Value ===<br />
<br />
Success: Returns a string containing the window handle value. <br />
<br />
Failure: Returns "" (blank string). <br />
<br />
=== Remarks ===<br />
<br />
This function is for use with the advanced WinTitleMatchMode options that allow you to use classnames and handles to specify windows rather than "title" and "text".<br />
<br />
Once you have obtained the handle you can access the required window even if its title changes.<br />
<br />
See "WinTitleMatchMode" in [[Core Function Opt|Opt]]<br />
<br />
=== Example ===<br />
<br />
<syntaxhighlight lang="sputnik"><br />
// Identify the Notepad window that contains the text "this one" and get a handle to it<br />
// Change into the WinTitleMatchMode that supports classnames and handles<br />
Opt("WinTitleMatchMode", 4);<br />
// Get the handle of a notepad window that contains "this one"<br />
$handle = WinGetHandle("classname=Notepad", "this one");<br />
If ( $handle )<br />
{<br />
    // Send some text directly to this window's edit control<br />
    ControlSend($handle, "", "Edit1", "AbCdE");<br />
}<br />
Else<br />
{<br />
    MsgBox("Could not find the correct window");<br />
}<br />
</syntaxhighlight><br />
<br />
[[Category:Core Function]]</div>
</article>
</main></body></html>