2014-01-07 12:35:13 +00:00
|
|
|
# screen
|
|
|
|
|
2016-04-21 22:35:29 +00:00
|
|
|
> Retrieve information about screen size, displays, cursor position, etc.
|
|
|
|
|
2016-11-23 19:20:56 +00:00
|
|
|
Process: [Main](../glossary.md#main-process), [Renderer](../glossary.md#renderer-process)
|
2016-11-03 17:26:00 +00:00
|
|
|
|
2016-09-16 18:38:32 +00:00
|
|
|
You cannot require or use this module until the `ready` event of the `app`
|
|
|
|
module is emitted.
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-10-13 21:09:14 +00:00
|
|
|
`screen` is an [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter).
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2015-11-12 13:20:09 +00:00
|
|
|
**Note:** In the renderer / DevTools, `window.screen` is a reserved DOM
|
2016-05-10 17:15:09 +00:00
|
|
|
property, so writing `let {screen} = require('electron')` will not work.
|
2016-06-07 04:55:25 +00:00
|
|
|
|
2015-01-16 21:57:16 +00:00
|
|
|
An example of creating a window that fills the whole screen:
|
|
|
|
|
|
|
|
```javascript
|
2016-06-07 04:55:25 +00:00
|
|
|
const electron = require('electron')
|
|
|
|
const {app, BrowserWindow} = electron
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-06-07 04:55:25 +00:00
|
|
|
let win
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-05-04 17:59:02 +00:00
|
|
|
app.on('ready', () => {
|
2016-06-07 04:55:25 +00:00
|
|
|
const {width, height} = electron.screen.getPrimaryDisplay().workAreaSize
|
|
|
|
win = new BrowserWindow({width, height})
|
2016-07-26 01:39:25 +00:00
|
|
|
win.loadURL('https://github.com')
|
|
|
|
})
|
2014-07-01 15:30:26 +00:00
|
|
|
```
|
2014-01-07 12:35:13 +00:00
|
|
|
|
2015-01-16 21:57:16 +00:00
|
|
|
Another example of creating a window in the external display:
|
|
|
|
|
|
|
|
```javascript
|
2016-06-07 04:55:25 +00:00
|
|
|
const electron = require('electron')
|
|
|
|
const {app, BrowserWindow} = require('electron')
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-06-07 04:55:25 +00:00
|
|
|
let win
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-05-04 17:59:02 +00:00
|
|
|
app.on('ready', () => {
|
2016-06-07 04:55:25 +00:00
|
|
|
let displays = electron.screen.getAllDisplays()
|
|
|
|
let externalDisplay = displays.find((display) => {
|
|
|
|
return display.bounds.x !== 0 || display.bounds.y !== 0
|
|
|
|
})
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
if (externalDisplay) {
|
2016-05-10 17:38:42 +00:00
|
|
|
win = new BrowserWindow({
|
2015-01-16 21:57:16 +00:00
|
|
|
x: externalDisplay.bounds.x + 50,
|
2015-10-05 13:56:36 +00:00
|
|
|
y: externalDisplay.bounds.y + 50
|
2016-06-07 04:55:25 +00:00
|
|
|
})
|
2016-07-26 01:39:25 +00:00
|
|
|
win.loadURL('https://github.com')
|
2015-01-16 21:57:16 +00:00
|
|
|
}
|
2016-06-07 04:55:25 +00:00
|
|
|
})
|
2015-01-16 21:57:16 +00:00
|
|
|
```
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
## Events
|
|
|
|
|
|
|
|
The `screen` module emits the following events:
|
|
|
|
|
|
|
|
### Event: 'display-added'
|
|
|
|
|
|
|
|
Returns:
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
* `event` Event
|
2016-09-28 07:00:01 +00:00
|
|
|
* `newDisplay` [Display](structures/display.md)
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
Emitted when `newDisplay` has been added.
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### Event: 'display-removed'
|
|
|
|
|
|
|
|
Returns:
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
* `event` Event
|
2016-09-28 07:00:01 +00:00
|
|
|
* `oldDisplay` [Display](structures/display.md)
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
Emitted when `oldDisplay` has been removed.
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### Event: 'display-metrics-changed'
|
|
|
|
|
|
|
|
Returns:
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
* `event` Event
|
2016-09-28 07:00:01 +00:00
|
|
|
* `display` [Display](structures/display.md)
|
2016-09-28 05:28:44 +00:00
|
|
|
* `changedMetrics` String[]
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
Emitted when one or more metrics change in a `display`. The `changedMetrics` is
|
2015-01-16 21:57:16 +00:00
|
|
|
an array of strings that describe the changes. Possible changes are `bounds`,
|
|
|
|
`workArea`, `scaleFactor` and `rotation`.
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
## Methods
|
|
|
|
|
|
|
|
The `screen` module has the following methods:
|
|
|
|
|
|
|
|
### `screen.getCursorScreenPoint()`
|
2014-01-07 12:35:13 +00:00
|
|
|
|
2017-04-03 22:35:39 +00:00
|
|
|
Returns [`Point`](structures/point.md)
|
2016-09-24 23:59:30 +00:00
|
|
|
|
|
|
|
The current absolute position of the mouse pointer.
|
2014-01-07 12:35:13 +00:00
|
|
|
|
2017-05-24 02:39:54 +00:00
|
|
|
### `screen.getMenuBarHeight()` _macOS_
|
2017-05-24 02:24:56 +00:00
|
|
|
|
2017-05-24 03:27:55 +00:00
|
|
|
Returns `Integer` - Height
|
2017-05-24 02:24:56 +00:00
|
|
|
|
|
|
|
The height of toolbar in pixels.
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### `screen.getPrimaryDisplay()`
|
2014-01-07 12:35:13 +00:00
|
|
|
|
2016-12-19 17:40:07 +00:00
|
|
|
Returns [`Display`](structures/display.md) - The primary display.
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### `screen.getAllDisplays()`
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-12-19 17:40:07 +00:00
|
|
|
Returns [`Display[]`](structures/display.md) - An array of displays that are currently available.
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### `screen.getDisplayNearestPoint(point)`
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2017-04-03 22:35:39 +00:00
|
|
|
* `point` [Point](structures/point.md)
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-12-19 17:40:07 +00:00
|
|
|
Returns [`Display`](structures/display.md) - The display nearest the specified point.
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### `screen.getDisplayMatching(rect)`
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-10-08 02:09:31 +00:00
|
|
|
* `rect` [Rectangle](structures/rectangle.md)
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2016-12-21 08:43:47 +00:00
|
|
|
Returns [`Display`](structures/display.md) - The display that most closely
|
2016-12-19 17:40:07 +00:00
|
|
|
intersects the provided bounds.
|