Differences

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

--- function:WINDOW [2019/12/25 03:56] – JMichaelTX
+++ function:WINDOW [2023/09/20 08:33] (current) – peternlewis
@@ Line 1: / Line 1: @@
-====== WINDOWS() Function ======
+====== WINDOW Function ======
+The WINDOW() function returns the desired coordinate of the specified window, and can have one or two parameters.
-**The `WINDOW()` function returns the desired coordinate of the specified window**, and can have one or two parameters. \\
-Like all [[:Functions|Functions]], it can be used _only_ in a [[:Text_Fields#Numeric_Fields|numeric calculation field]].
 ====== Usage ======
-  - **`WINDOW(Coordinate)`**
+  - WINDOW(Coordinate)
-    - The `Index` is assumed to be the window of the Action in which the `WINDOW()` function is used (like the [Manipulate a Window](action:Manipulate a Window)), \\ OR, the frontmost window if the Action does not refer to a window.
+  - WINDOW(Index, Coordinate)
-  - **`WINDOW(Index, Coordinate)`**
-    - With two parameters, the first parameter specifies which window in the front application to operate on.
+With two parameters, the first parameter specifies which window in the front application to operate on. With only one parameter, the *Index* is assumed to be the window of the Action in which the *WINDOW()* function is used (like the [[action:Manipulate_a_Window|Manipulate a Window]] action), or the frontmost window if the Action does not refer to a window.
 ====== Parameters ======
+The first parameter, *Index*, which is optional, may be:
-The first parameter, `Index`, which is optional, may be:
 * 0: the frontmost window of the frontmost app.
 * Positive Number: the indexed window from front to back.
 * Negative Number: the indexed window from back to front.
-* If this parameter is _not_ provided, then it is assumed to be the window of the Action in which the `WINDOW()` function is used, \\ OR, the frontmost window if the Action does not refer to a window.
 The second parameter, `Coordinate`, specifies the desired *coordinate* to be returned, and can be:
@@ Line 36: / Line 31: @@
 ====== See Also ======
-----
 ===== Actions =====
-* [[action:Login Window|Login Window]]
+* [[action:Manipulate a Window|Manipulate a Window]] action
-* [[action:Manipulate a Window|Manipulate a Window]]
+* [[action:Move or Click Mouse|Move or Click Mouse]] action
-* [[action:Move or Click Mouse|Move or Click Mouse]]
+* [[action:Custom_HTML_Prompt|Custom HTML Prompt]] action
 * [[:Actions|See all Actions]]
 ===== Functions =====
-* [[function:MENUBARHEIGHT|MENUBARHEIGHT()]]
+* [[MENUBARHEIGHT]]
-* [[function:MOUSEBUTTON|MOUSEBUTTON()]]
+* [[MOUSEBUTTON]]
-* [[function:MOUSEX|MOUSEX()]]
+* [[MOUSEX]]
-* [[function:MOUSEY|MOUSEY()]]
+* [[MOUSEY]]
-* [[function:SCREEN|SCREEN()]]
+* [[SCREEN]]
-* [[function:SCREENCOUNT|SCREENCOUNT()]]
+* [[SCREENCOUNT]]
-* [[function:SCREENVISIBLE|SCREENVISIBLE()]]
+* [[SCREENVISIBLE]]
-* [[function:WINDOWCOUNT|WINDOWCOUNT()]]
+* [[SCREENINDEX]]
+* [[WINDOWCOUNT]]
 * [[:Functions|See all Functions]]
 ===== Tokens =====
-* [[:token:FrontWindowName|%FrontWindowName%]]
+* [[:token:FrontWindowName|%FrontWindowName%]] token
-* [[:token:WindowName|%WindowName%]]
+* [[:token:WindowName|%WindowName%]] token
-* [[token:WindowSize|%WindowSize%]]
+* [[token:WindowSize|%WindowSize%]] token
 * [[:Tokens|See all Tokens]]
-----
 ===== Forum =====
 - [[https://forum.keyboardmaestro.com/t/send-the-front-most-window-to-back-bring-the-back-to-front/2226/19|Send the front most window to back? bring the back to front?]]
 - [[https://forum.keyboardmaestro.com/t/i-need-a-conditional-if-there-are-two-monitors/3031/5|I need a conditional if there are two monitors]]
 - [[https://forum.keyboardmaestro.com/search?q=WINDOW|Keyboard Maestro Forum topics about Window function]]