Differences

This shows you the differences between two versions of the page.

--- token:Window_Tokens [2019/07/05 07:45] – created peternlewis
+++ token:Window_Tokens [2026/07/27 04:49] (current) – remove redundant links peternlewis
@@ Line 3: / Line 3: @@
 This Wiki page receives the redirect for a number or windows related tokens:
-  * [[token:WindowName|%WindowName%]] and [[token:FrontWindowName|%FrontWindowName%]]
+  * `%WindowName%` and `%FrontWindowName%`
-  * [[token:WindowFrame|%WindowFrame%]] and [[token:FrontWindowFrame|%FrontWindowFrame%]]
+  * `%WindowFrame%` and `%FrontWindowFrame%`
-  * [[token:WindowPosition|%WindowPosition%]] and [[token:FrontWindowPosition|%FrontWindowPosition%]]
+  * `%WindowPosition%` and `%FrontWindowPosition%`
-  * [[token:WindowSize|%WindowSize%]] and [[token:FrontWindowSize|%FrontWindowSize%]]
+  * `%WindowSize%` and `%FrontWindowSize%`
 Each of these text tokens return information about the specified window.
@@ Line 16: / Line 16: @@
 The parameter may be:
-* Front or 0: the focused/main window. Usually the same as index 1.
+^ Parameter ^ Meaning ^
-* Positive Number: the indexed window from front to back.
+| Front or 0 | the focused/main window. Usually the same as index 1. |
-* Negative Number: the indexed window from back to front.
+| Positive Number | the indexed window from front to back. |
+| Negative Number | the indexed window from back to front. |
+| All | All of the windows, one per line, from front to back. |
 So for example, //%WindowFrame%1%// gives the frame of the front window (the same as `%FrontWindowFrame%`).
@@ Line 48: / Line 50: @@
 ==== WindowPosition (FrontWindowPosition) ====
-The `%WindowPosition%` tokens returns the location of the window in pixels of left and top of the window in a comma-delimited numerical string.
+The `%WindowPosition%` token returns the location of the window in pixels of left and top of the window in a comma-delimited numerical string.
 `%FrontWindowPosition%` is a synonym for `%WindowPosition%Front%` and may be used interchangeably.
@@ Line 62: / Line 64: @@
 ==== WindowSize (FrontWindowSize) ====
-The `%WindowSize%` tokens returns the size of the window in pixels of width and height of the window in a comma-delimited numerical string.
+The `%WindowSize%` token returns the size of the window in pixels of width and height of the window in a comma-delimited numerical string.
 `%FrontWindowSize%` is a synonym for `%WindowSize%Front%` and may be used interchangeably.
@@ Line 73: / Line 75: @@
 ```
-==== Accessing Window and Screen Coordinates ====
+==== Accessing Window, Screen, & Image Coordinates ====
-When a Window or screen token returns a set of 4 comma-delimited values as one result into a Keyboard Maestro Variable (which is always text), you can access the individual values, and calculate other values, by using certain key words appended to the Variable name in a [[token:Calculate|Calculate Token]], such as the following:
+When a Window, screen token or a [[token:FoundImage|FoundImage Token]] returns a set of 4 comma-delimited values as one result into a Keyboard Maestro Variable (which is always text), you can access the individual values, and calculate other values, by using certain _coordinate names_ appended to the Variable name in a [[token:Calculate|Calculate Token]], such as the following:
 {{:token:km-7.3-window-coordinates.png?nolink|}}
@@ Line 97: / Line 99: @@
 For WindowPosition, you can use Left and Top, and for WindowSize you can use Width and Height.
-=== Screen/Window Keyword "coordinates" ===
+=== Screen/Window/Image Coordinate Names ===
@@ Line 129: / Line 131: @@
 * [[token:WindowPosition|%WindowPosition%]]
 * [[token:WindowSize|%WindowSize%]]
+* [[token:FoundImage|FoundImage Token]]
 * [[:Tokens|See all Tokens]]