This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | Next revision Both sides next revision | ||
function:SCREEN [2020/06/11 04:25] peternlewis |
function:SCREEN [2021/10/15 02:32] peternlewis |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== SCREEN, SCREENVISIBLE and SCREENINDEX Functions ====== | ||
+ | |||
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. | 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 ) | + | The //SCREENINDEX()// function returns (v10.0+) the actual index of the specified screen, counting from left to right. |
- | SCREEN( index [number OR name], coordinate, percentage ) | + | |
+ | ``` | ||
+ | SCREEN( index [number OR name], coordinate ) | ||
+ | SCREEN( index [number OR name], coordinate, percentage ) | ||
+ | ``` | ||
The SCREEN *index* can be referenced by either a _number_ OR a _name_. The _Index number_ can be 0 for the main screen, and then 1 through n are the screens in orientation order from left to right (and top down for screens at the same position). _Index Names_ are shown below. | The SCREEN *index* can be referenced by either a _number_ OR a _name_. The _Index number_ can be 0 for the main screen, and then 1 through n are the screens in orientation order from left to right (and top down for screens at the same position). _Index Names_ are shown below. | ||
The _Main_ screen is set by your macOS System Preferences. | The _Main_ screen is set by your macOS System Preferences. | ||
+ | |||
The other screens (monitors) are referenced positionally from the left most screen, which may, or _may not_, be the _Main_ screen. | The other screens (monitors) are referenced positionally from the left most screen, which may, or _may not_, be the _Main_ screen. | ||
Line 23: | Line 30: | ||
| Variable Name | the index value based on the value of the variable (v9.0+). | | | 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: |
* SCREEN(0) is always the _Main_ screen. | * SCREEN(0) is always the _Main_ screen. | ||
* SCREEN(1) may or may not be the _Main_ screen. | * SCREEN(1) may or may not be the _Main_ screen. | ||
* SCREEN(2+) may or may not be the _Main_ screen. | * SCREEN(2+) may or may not be the _Main_ screen. | ||
- | |||
The SCREEN *coordinate* can be: | The SCREEN *coordinate* can be: |