Window Titles and Text Advanced

From Sputnik Wiki
(Difference between revisions)
Jump to: navigation, search
(Created page with "=== Description === Sputnik operates in one of five "Window matching" modes. The modes are set with the Opt() function using the WinTitleMatchMode and WinTextMatchMode option. ...")
 
Line 33: Line 33:
 
'''Mode 3'''
 
'''Mode 3'''
  
Matches any substring in the title.
+
Matches any sub-string in the title.
  
 
In this mode a window titled Untitled - Notepad would be matched by "Untitled - Notepad", "Untitled", "Notepad", "pad", "d - N", etc.
 
In this mode a window titled Untitled - Notepad would be matched by "Untitled - Notepad", "Untitled", "Notepad", "pad", "d - N", etc.
Line 68: Line 68:
  
 
* 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 classname
+
* 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

Revision as of 19:57, 4 December 2011

Description

Sputnik operates in one of five "Window matching" modes.

The modes are set with the Opt() function using the WinTitleMatchMode and WinTextMatchMode option.

Remarks

Mode 1 (default)

Matches partial titles from the start.

In this mode the a window titled Untitled - Notepad would be matched by "Untitled - Notepad", "Untitled", "Un", etc.

e.g.

WinWait("Untitled");

Mode 2

Matches partial titles from the end.

In this mode the a window titled Untitled - Notepad would be matched by "Untitled - Notepad", "Notepad", "pad", etc.

e.g.

WinWait("pad");

Mode 3

Matches any sub-string in the title.

In this mode a window titled Untitled - Notepad would be matched by "Untitled - Notepad", "Untitled", "Notepad", "pad", "d - N", etc.

e.g.

WinWait("Notepad");

Mode 4

Exact title match.

In this mode a window titled Untitled - Notepad would only be matched by "Untitled - Notepad"

e.g.

WinWait("Untitled - Notepad");

Mode 5

Advanced mode.

Must be replaced with Advanced Window Descriptions which does not need any mode to be set.

Advanced Window Descriptions

A special description can be used as the window title parameter.

This description can be used to identify a window by the following properties:

One or more properties are used in the title parameter of a window command in the format:

[PROPERTY1=Value1; PROPERTY2=Value2]

e.g. Wait a window of classname "Notepad"

WinWaitActive("[CLASS=Notepad]", "");

e.g. Close the currently active window

WinClose("[ACTIVE]", "");

e.g. Wait for the 2nd instance of a window with title "My Window" and classname "My Class"

WinWait("[TITLE=My Window; CLASS=My Class; INSTANCE=2]", "");

e.g. Wait for the 2nd instance of a notepad

WinWait("[class=Notepad;INSTANCE=3]");

e.g. List windows matching a classname defined by a regular expression

WinList("[CLASSRX=#\d+]")
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox