User Tools

Site Tools


function:SCREEN

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 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:
function/SCREEN.txt · Last modified: 2023/09/20 03:47 by peternlewis