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 [2016/02/27 02:30]
AlainLifchitz add internal links
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/​focussed/​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 ===== 
 + 
 +* [[action:​Manipulate a Window|Manipulate a Window]] action 
 +* [[action:​Move or Click Mouse|Move or Click Mouse]] action 
 +* [[action:​Custom_HTML_Prompt|Custom HTML Prompt]] action 
 +* [[:​Actions|See all Actions]] 
 + 
 +===== Functions ===== 
 + 
 +* [[MENUBARHEIGHT]] 
 +* [[MOUSEBUTTON]] 
 +* [[MOUSEX]] 
 +* [[MOUSEY]] 
 +* [[SCREEN]] 
 +* [[SCREENCOUNT]] 
 +* [[SCREENVISIBLE]] 
 +* [[SCREENINDEX]] 
 +* [[WINDOWCOUNT]] 
 +* [[:​Functions|See all Functions]] 
 + 
 +===== Tokens ​=====
  
-==== Documentation ====+* [[:​token:​FrontWindowName|%FrontWindowName%]] token 
 +* [[:​token:​WindowName|%WindowName%]] token 
 +* [[token:​WindowSize|%WindowSize%]] token 
 +* [[:​Tokens|See all Tokens]]
  
-* [[action:​Manipulate a Window|action:​Manipulate a Window]], [[action:​Move or Click Mouse|action:​Move or Click Mouse]] +===== Forum =====
-* [[function:​MENUBARHEIGHT|function:​MENUBARHEIGHT]],​ [[function:​MOUSEBUTTON|function:​MOUSEBUTTON]],​ [[function:​MOUSEX|function:​MOUSEX]],​ [[function:​MOUSEY|function:​MOUSEY]],​ [[function:​SCREEN|function:​SCREEN]],​ [[function:​SCREENCOUNT|function:​SCREENCOUNT]],​ [[function:​SCREENVISIBLE| function:​SCREENVISIBLE]],​ [[function:​WINDOWCOUNT|function:​WINDOWCOUNT]]+
  
 +- [[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]]
function/WINDOW.1456558225.txt.gz · Last modified: 2016/02/27 02:30 by AlainLifchitz