SCREEN COORDINATES
SCREEN COORDINATES ( left ; top ; right ; bottom {; screenID {; screenArea}} )
| Parameter | Type | Description | |
|---|---|---|---|
| left | Integer | ← | Global left coordinate of screen area |
| top | Integer | ← | Global top coordinate of screen area |
| right | Integer | ← | Global right coordinate of screen area |
| bottom | Integer | ← | Global bottom coordinate of screen area |
| screenID | Integer | → | Screen number, or main screen if omitted |
| screenArea | Integer | → | Entire screen (default) or working area |
This command is not thread-safe, it cannot be used in preemptive code.
Description
The SCREEN COORDINATES command returns in left, top, right, and bottom the global coordinates of the screen specified by screenID.
If you omit the screenID parameter, the command returns the coordinates of the main screen.
The optional screenArea parameter lets you specify if you want the coordinates for the entire screen area (default) or only for the available usable area. Two selectors are available:
| Constant | Value | Comment |
|---|---|---|
| Screen size | 0 | The coordinates of the entire screen. (default value) |
| Screen work area | 1 | The coordinates of the available screen area that can be used (i.e., they are not occupied by Windows taskbar or macOS menu bar and Dock). |
The following images demonstrate the differences between the screen size and the work area:
Notes:
- If the taskbar or dock is automatically hidden, SCREEN COORDINATES always returns the entire screen size.
- If an invalid value is given in screenID or screenArea, a zero is returned for all of the coordinates.