Window Titles and Text Advanced - Revision history

UberFoX: 1 revision

2015-06-14T12:37:01Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:48Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX: /* Remarks */

2013-10-19T08:31:47Z

Remarks

← Older revision		Revision as of 08:31, 19 October 2013
Line 7:		Line 7:
	=== Remarks ===		=== Remarks ===

−	'''Mode 0 (default)'''	+	'''Mode 1 (default)'''
		+
		+	@MatchModeLeft

	Matches partial titles from the start.		Matches partial titles from the start.
Line 19:		Line 21:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 1'''	+	'''Mode 2'''
		+
		+	@MatchModeRight

	Matches partial titles from the end.		Matches partial titles from the end.
Line 31:		Line 35:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 2'''	+	'''Mode 3'''
		+
		+	@MatchModePartial

	Matches any sub-string in the title.		Matches any sub-string in the title.
Line 43:		Line 49:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 3'''	+	'''Mode 4'''
		+
		+	@MatchModeFull

	Exact title match.		Exact title match.
Line 55:		Line 63:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 4'''	+	'''Mode 5'''
		+
		+	@MatchModeAdvanced

	Advanced mode.		Advanced mode.

UberFoX at 03:40, 19 October 2013

2013-10-19T03:40:36Z

← Older revision		Revision as of 03:40, 19 October 2013
Line 110:		Line 110:
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
	WinList("[CLASSRX=#\d+]")		WinList("[CLASSRX=#\d+]")
		+	</syntaxhighlight>
		+
		+	e.g. Use a ; in the title, text or a regex by placing it as ;;
		+
		+	<syntaxhighlight lang="sputnik">
		+	WinList("[CLASSRX=#;;\d+]")
	</syntaxhighlight>		</syntaxhighlight>

UberFoX at 02:37, 19 October 2013

2013-10-19T02:37:36Z

← Older revision		Revision as of 02:37, 19 October 2013
Line 7:		Line 7:
	=== Remarks ===		=== Remarks ===

−	'''Mode 1 (default)'''	+	'''Mode 0 (default)'''

	Matches partial titles from the start.		Matches partial titles from the start.
Line 19:		Line 19:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 2'''	+	'''Mode 1'''

	Matches partial titles from the end.		Matches partial titles from the end.
Line 31:		Line 31:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 3'''	+	'''Mode 2'''

	Matches any sub-string in the title.		Matches any sub-string in the title.
Line 43:		Line 43:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 4'''	+	'''Mode 3'''

	Exact title match.		Exact title match.
Line 55:		Line 55:
	</syntaxhighlight>		</syntaxhighlight>

−	'''Mode 5'''	+	'''Mode 4'''

	Advanced mode.		Advanced mode.

UberFoX: /* Window Handles / HWNDs */

2013-10-19T02:35:55Z

Window Handles / HWNDs

← Older revision		Revision as of 02:35, 19 October 2013
Line 113:		Line 113:

	=== Window Handles / HWNDs ===		=== Window Handles / HWNDs ===
−	The SV datatype in Sputnik supports window handles (HWNDs) as ~~Int64~~. A window handle is a special value that windows assigns to a window each time it is created. When you have a handle you may use it in place of the title parameter in any of the function calls that use the title/text convention. The advantage of using window handles is that if you have multiple copies of an application open - which have the same title/text - you can uniquely identify them when using handles. When you use a window handle for the title parameter then the text parameter is completely ignored.	+	The SV datatype in Sputnik supports window handles (HWNDs) as IntPtr. A window handle is a special value that windows assigns to a window each time it is created. When you have a handle you may use it in place of the title parameter in any of the function calls that use the title/text convention. The advantage of using window handles is that if you have multiple copies of an application open - which have the same title/text - you can uniquely identify them when using handles. When you use a window handle for the title parameter then the text parameter is completely ignored.

	Various functions such as WinGetHandle and WinList etc return these handles.		Various functions such as WinGetHandle and WinList etc return these handles.

UberFoX: /* Remarks */

2011-12-05T00:24:16Z

Remarks

← Older revision		Revision as of 00:24, 5 December 2011
Line 82:		Line 82:
	[PROPERTY1=Value1; PROPERTY2=Value2]		[PROPERTY1=Value1; PROPERTY2=Value2]
	</syntaxhighlight>		</syntaxhighlight>
		+	'''Note''' : if a Value must contain a ";" it must be doubled.

	e.g. Wait a window of classname "Notepad"		e.g. Wait a window of classname "Notepad"
Line 111:		Line 112:
	</syntaxhighlight>		</syntaxhighlight>

		+	=== Window Handles / HWNDs ===
		+	The SV datatype in Sputnik supports window handles (HWNDs) as Int64. A window handle is a special value that windows assigns to a window each time it is created. When you have a handle you may use it in place of the title parameter in any of the function calls that use the title/text convention. The advantage of using window handles is that if you have multiple copies of an application open - which have the same title/text - you can uniquely identify them when using handles. When you use a window handle for the title parameter then the text parameter is completely ignored.
		+
		+	Various functions such as WinGetHandle and WinList etc return these handles.
		+
		+	Note: Window handles will work no matter what WinTitleMatchMode/WinTextMatchMode is currently in use.
	[[Category:Core Function]]		[[Category:Core Function]]

UberFoX at 20:49, 4 December 2011

2011-12-04T20:49:29Z

← Older revision		Revision as of 20:49, 4 December 2011
Line 68:		Line 68:

	* '''TITLE''' - Window title		* '''TITLE''' - Window title
		+	* '''TITLERX''' - Match Window title using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)
	* '''TEXT''' - Window text		* '''TEXT''' - Window text
		+	* '''TEXTRX''' - Match Window text using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)
	* '''CLASS''' - The internal window class name		* '''CLASS''' - The internal window class name
		+	* '''CLASSRX''' - Match class using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)
	* '''ACTIVE''' - Currently active window		* '''ACTIVE''' - Currently active window
	* '''NOTACTIVE''' - This will not count the current active window in the search		* '''NOTACTIVE''' - This will not count the current active window in the search
−	* '''CLASSRX''' - Match class using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)
−	* '''REGEX''' - Match title or text using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)
	* '''INSTANCE''' - The 1-based instance when all given properties match		* '''INSTANCE''' - The 1-based instance when all given properties match

UberFoX at 20:48, 4 December 2011

2011-12-04T20:48:01Z

← Older revision		Revision as of 20:48, 4 December 2011
Line 67:		Line 67:
	This description can be used to identify a window by the following properties:		This description can be used to identify a window by the following properties:

−	* '''TITLE''' - Window title ~~(If used on Title param however if used on Text param it will match against the found~~ text ~~rather than the title)~~	+	* '''TITLE''' - Window title
		+	* '''TEXT''' - Window text
	* '''CLASS''' - The internal window class name		* '''CLASS''' - The internal window class name
	* '''ACTIVE''' - Currently active window		* '''ACTIVE''' - Currently active window

UberFoX at 19:58, 4 December 2011

2011-12-04T19:58:10Z

← Older revision		Revision as of 19:58, 4 December 2011
Line 67:		Line 67:
	This description can be used to identify a window by the following properties:		This description can be used to identify a window by the following properties:

−	* TITLE - Window title (If used on Title param however if used on Text param it will match against the found text rather than the title)	+	* '''TITLE''' - Window title (If used on Title param however if used on Text param it will match against the found text rather than the title)
−	* CLASS - The internal window class name	+	* '''CLASS''' - The internal window class name
−	* ACTIVE - Currently active window	+	* '''ACTIVE''' - Currently active window
−	* NOTACTIVE - This will not count the current active window in the search	+	* '''NOTACTIVE''' - This will not count the current active window in the search
−	* CLASSRX - Match class using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)	+	* '''CLASSRX''' - Match class using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)
−	* REGEX - Match title or text using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)	+	* '''REGEX''' - Match title or text using a regular expression (Can be used on Title or Text params or both params to match the the given text of each param)
−	* INSTANCE - The 1-based instance when all given properties match	+	* '''INSTANCE''' - The 1-based instance when all given properties match

	One or more properties are used in the title parameter of a window command in the format:		One or more properties are used in the title parameter of a window command in the format:
Line 100:		Line 100:
	e.g. Wait for the 2nd instance of a notepad		e.g. Wait for the 2nd instance of a notepad
	<syntaxhighlight lang="sputnik">		<syntaxhighlight lang="sputnik">
−	WinWait("[class=Notepad;INSTANCE=3]");	+	WinWait("[class=Notepad;INSTANCE=2]");
	</syntaxhighlight>		</syntaxhighlight>