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:SCREEN [2017/04/26 23:29] JMichaelTX |
function:SCREEN [2019/07/04 03:23] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | The [[function:SCREEN|SCREEN()]] and [[function:SCREENVISIBLE|SCREENVISIBLE()]] functions return the position or size of a screen. [[function:SCREENVISIBLE|SCREENVISIBLE()]] refers to the visible section of the screen, excluding the menu bar and the dock. | + | The //SCREEN()// and //SCREENVISIBLE// functions return the position or size of a screen. //SCREENVISIBLE()// refers to the visible section of the screen, excluding the menu bar and the dock. |
SCREEN( index [number OR name], coordinate ) | SCREEN( index [number OR name], coordinate ) | ||
Line 10: | Line 10: | ||
^ Index Name ^ Description ^ | ^ Index Name ^ Description ^ | ||
- | | **Main** | the screen with the primary menu bar (as configured in the Displays preferences).| | + | | Main or 0 | the screen with the primary menu bar (as configured in the Displays preferences).| |
| Second |the first from the left which is not the _Main_ screen.| | | Second |the first from the left which is not the _Main_ screen.| | ||
| Third | the second from the left which is not the _Main_ screen.| | | Third | the second from the left which is not the _Main_ screen.| | ||
Line 19: | Line 19: | ||
| Back | the first from the left not containing (the most of) the front window.| | | Back | the first from the left not containing (the most of) the front window.| | ||
| Back2 | the second left most screen not containing (the most of) the front window.| | | Back2 | the second left most screen not containing (the most of) the front window.| | ||
+ | | Positive Calculation | the indexed screen from left to right. | | ||
+ | | Negative Calculation | the indexed screen from right to left. | | ||
+ | | Variable Name | the index value based on the value of the variable (v9.0+). | | ||
:!: Note: Since the _Main_ screen can be in any position, be advised of the following: | :!: Note: Since the _Main_ screen can be in any position, be advised of the following: | ||
Line 36: | Line 39: | ||
* MidX | * MidX | ||
* MidY | * MidY | ||
+ | * Index (v9.0+) | ||
The optional SCREEN *percentage* parameter specifies a percentage of the width or height to offset by. Offsets are always to the right and down, but negative offsets are allowed. | The optional SCREEN *percentage* parameter specifies a percentage of the width or height to offset by. Offsets are always to the right and down, but negative offsets are allowed. | ||
Line 46: | Line 50: | ||
===== See Also ===== | ===== See Also ===== | ||
- | |||
- | ---- | ||
==== Actions ==== | ==== Actions ==== | ||
Line 71: | Line 73: | ||
* [[token:ScreenVisible|%ScreenVisible%]] | * [[token:ScreenVisible|%ScreenVisible%]] | ||
* [[:Tokens|See all Tokens]] | * [[:Tokens|See all Tokens]] | ||
- | |||
- | ---- | ||
==== Forum ==== | ==== Forum ==== | ||
- | - [[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/|I need a conditional if there are two monitors]] |
- [[https://forum.keyboardmaestro.com/search?q=Screen|Keyboard Maestro Forum topics about Screen]] | - [[https://forum.keyboardmaestro.com/search?q=Screen|Keyboard Maestro Forum topics about Screen]] | ||