User Tools

Site Tools


function:WINDOW

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
function:WINDOW [2019/12/24 22:57]
JMichaelTX
function:WINDOW [2021/10/15 04:28]
peternlewis [Tokens]
Line 1: Line 1:
 ====== WINDOW() 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]]. Like all [[:​Functions|Functions]],​ it can be used _only_ in a [[:​Text_Fields#​Numeric_Fields|numeric calculation field]].
  
 ====== Usage ====== ====== 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 [Manipulate a Window](action:​Manipulate a Window)), or the frontmost window if the Action does not refer to a window.
  
 ====== Parameters ====== ====== 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. * 0: the frontmost window of the frontmost app.
 * Positive Number: the indexed window from front to back. * Positive Number: the indexed window from front to back.
 * Negative Number: the indexed window from back to front. * 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: The second parameter, `Coordinate`,​ specifies the desired *coordinate* to be returned, and can be:
Line 36: Line 34:
  
 ====== See Also ====== ====== See Also ======
- 
- 
----- 
  
 ===== Actions ===== ===== 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]] * [[:​Actions|See all Actions]]
  
 ===== Functions ===== ===== Functions =====
  
-* [[function:​MENUBARHEIGHT|MENUBARHEIGHT()]] +* [[function:​MENUBARHEIGHT|MENUBARHEIGHT()]] ​function 
-* [[function:​MOUSEBUTTON|MOUSEBUTTON()]] +* [[function:​MOUSEBUTTON|MOUSEBUTTON()]] ​function 
-* [[function:​MOUSEX|MOUSEX()]] +* [[function:​MOUSEX|MOUSEX()]] ​function 
-* [[function:​MOUSEY|MOUSEY()]] +* [[function:​MOUSEY|MOUSEY()]] ​function 
-* [[function:​SCREEN|SCREEN()]] +* [[function:​SCREEN|SCREEN()]] ​function 
-* [[function:​SCREENCOUNT|SCREENCOUNT()]] +* [[function:​SCREENCOUNT|SCREENCOUNT()]] ​function 
-* [[function:​SCREENVISIBLE|SCREENVISIBLE()]] +* [[function:​SCREENVISIBLE|SCREENVISIBLE()]] ​function 
-* [[function:​WINDOWCOUNT|WINDOWCOUNT()]]+* [[function:​SCREENINDEX|SCREENINDEX()]] function 
 +* [[function:​WINDOWCOUNT|WINDOWCOUNT()]] ​function
 * [[:​Functions|See all Functions]] * [[:​Functions|See all Functions]]
  
 ===== Tokens ===== ===== 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]] * [[:​Tokens|See all Tokens]]
- 
----- 
  
 ===== Forum ===== ===== 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/​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/​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]] - [[https://​forum.keyboardmaestro.com/​search?​q=WINDOW|Keyboard Maestro Forum topics about Window function]]
function/WINDOW.txt · Last modified: 2023/09/20 04:33 by peternlewis