This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
function:WINDOW [2016/03/08 07:55] AlainLifchitz add internal link + JMTX template |
function:WINDOW [2021/10/15 04:28] peternlewis [Functions] |
||
---|---|---|---|
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. | + | Like all [[:Functions|Functions]], it can be used _only_ in a [[:Text_Fields#Numeric_Fields|numeric calculation field]]. |
+ | |||
+ | ====== 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 [Manipulate a Window](action:Manipulate a Window)), 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 32: | ||
* 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:Manipulate a Window|Manipulate a Window]] | + | * [[action:Custom_HTML_Prompt|Custom HTML Prompt]] action |
- | * [[action:Move or Click Mouse|Move or Click Mouse]] | + | |
* [[: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:WindowName|%WindowName%]] | ||
* [[token:WindowSize|%WindowSize%]] | * [[token:WindowSize|%WindowSize%]] | ||
* [[: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/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]] |