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
function:WINDOW [2017/03/05 21:24]
peternlewis [Forum]
function:WINDOW [2023/09/20 04:33] (current)
peternlewis
Line 1: Line 1:
-The WINDOW() function takes one or two parameters and returns information about a window. ​ With one parameter, it refers to the window that that action is operating on in actions like the [Manipulate a Window](action:​Manipulate a Window). ​ If the action does not refer to a window, then the function refers to the main/​focused/​front window. ​ With two parameters, the first parameter specifies which window in the front application to operate on.+====== ​WINDOW ​Function ======
  
-The first parameter may be:+The WINDOW() function returns the desired coordinate of the specified window, and can have one or two parameters.
  
-* 0: the main or action ​window.+====== Usage ====== 
 + 
 +  - WINDOW(Coordinate) 
 +  - WINDOW(Index,​ Coordinate) 
 + 
 +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: 
 + 
 +* 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.
  
-The second parameter specifies the desired *coordinate* and can be:+The second parameter, `Coordinate`, ​specifies the desired *coordinate* ​to be returned, ​and can be:
  
 * Left * Left
Line 18: Line 29:
 * MidY * MidY
  
-The WINDOW() function returns the desired coordinate of the specified window. 
  
-===== See Also =====+====== See Also ======
  
-----+===== Actions =====
  
-=== Actions === +* [[action:​Manipulate a Window|Manipulate a Window]] ​action 
- +* [[action:​Move or Click Mouse|Move or Click Mouse]] ​action 
-* [[action:​Login Window|Login Window]] +* [[action:​Custom_HTML_Prompt|Custom HTML Prompt]] action
-* [[action:​Manipulate a Window|Manipulate a Window]] +
-* [[action:​Move or Click Mouse|Move or Click Mouse]]+
 * [[:​Actions|See all Actions]] * [[:​Actions|See all Actions]]
  
-=== Functions ===+===== 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]] * [[:​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.1488767065.txt.gz · Last modified: 2017/03/05 21:24 by peternlewis