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 [2019/12/24 22:55] JMichaelTX |
function:WINDOW [2021/10/15 02:40] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | **The `WINDOW()` function returns the desired coordinate of the specified window**, and can have one or two parameters. \\ | + | ====== WINDOW() Function ====== |
+ | |||
+ | 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 33: | Line 34: | ||
====== See Also ====== | ====== See Also ====== | ||
- | |||
- | |||
- | ---- | ||
===== Actions ===== | ===== Actions ===== | ||
- | * [[action:Login Window|Login Window]] | ||
* [[action:Manipulate a Window|Manipulate a Window]] | * [[action:Manipulate a Window|Manipulate a Window]] | ||
* [[action:Move or Click Mouse|Move or Click Mouse]] | * [[action:Move or Click Mouse|Move or Click Mouse]] | ||
Line 63: | Line 60: | ||
* [[: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]] |