2014-01-07 12:35:13 +00:00
|
|
|
# screen
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
The `screen` module retrieves information about screen size, displays, cursor
|
2016-04-22 13:56:24 +00:00
|
|
|
position, etc. You can not use this module until the `ready` event of the
|
2016-04-18 16:04:47 +00:00
|
|
|
`app` module is emitted (by invoking or requiring it).
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
`screen` is an [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter).
|
|
|
|
|
2015-11-12 13:20:09 +00:00
|
|
|
**Note:** In the renderer / DevTools, `window.screen` is a reserved DOM
|
|
|
|
property, so writing `var screen = require('electron').screen` will not work.
|
|
|
|
In our examples below, we use `electronScreen` as the variable name instead.
|
2015-01-16 21:57:16 +00:00
|
|
|
An example of creating a window that fills the whole screen:
|
|
|
|
|
|
|
|
```javascript
|
2015-11-12 13:20:09 +00:00
|
|
|
const electron = require('electron');
|
|
|
|
const app = electron.app;
|
|
|
|
const BrowserWindow = electron.BrowserWindow;
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
var mainWindow;
|
|
|
|
|
|
|
|
app.on('ready', function() {
|
2015-11-12 13:20:09 +00:00
|
|
|
var electronScreen = electron.screen;
|
2015-09-27 13:20:35 +00:00
|
|
|
var size = electronScreen.getPrimaryDisplay().workAreaSize;
|
2015-01-16 21:57:16 +00:00
|
|
|
mainWindow = new BrowserWindow({ width: size.width, height: size.height });
|
|
|
|
});
|
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
|
2015-11-12 13:20:09 +00:00
|
|
|
const electron = require('electron');
|
|
|
|
const app = electron.app;
|
|
|
|
const BrowserWindow = electron.BrowserWindow;
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
var mainWindow;
|
|
|
|
|
|
|
|
app.on('ready', function() {
|
2015-11-12 13:20:09 +00:00
|
|
|
var electronScreen = electron.screen;
|
2015-09-27 13:20:35 +00:00
|
|
|
var displays = electronScreen.getAllDisplays();
|
2015-01-16 21:57:16 +00:00
|
|
|
var externalDisplay = null;
|
2015-10-05 03:41:06 +00:00
|
|
|
for (var i in displays) {
|
|
|
|
if (displays[i].bounds.x != 0 || displays[i].bounds.y != 0) {
|
2015-01-16 21:57:16 +00:00
|
|
|
externalDisplay = displays[i];
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if (externalDisplay) {
|
|
|
|
mainWindow = new BrowserWindow({
|
|
|
|
x: externalDisplay.bounds.x + 50,
|
2015-10-05 13:56:36 +00:00
|
|
|
y: externalDisplay.bounds.y + 50
|
2015-01-16 21:57:16 +00:00
|
|
|
});
|
|
|
|
}
|
|
|
|
});
|
|
|
|
```
|
|
|
|
|
2016-01-07 12:21:11 +00:00
|
|
|
## The `Display` object
|
|
|
|
|
|
|
|
The `Display` object represents a physical display connected to the system. A
|
|
|
|
fake `Display` may exist on a headless system, or a `Display` may correspond to
|
|
|
|
a remote, virtual display.
|
|
|
|
|
|
|
|
* `display` object
|
|
|
|
* `id` Integer - Unique identifier associated with the display.
|
2016-04-22 10:32:11 +00:00
|
|
|
* `rotation` Integer - Can be 0, 90, 180, 270, represents screen rotation in
|
|
|
|
clock-wise degrees.
|
2016-01-07 12:21:11 +00:00
|
|
|
* `scaleFactor` Number - Output device's pixel scale factor.
|
|
|
|
* `touchSupport` String - Can be `available`, `unavailable`, `unknown`.
|
|
|
|
* `bounds` Object
|
|
|
|
* `size` Object
|
|
|
|
* `workArea` Object
|
|
|
|
* `workAreaSize` Object
|
|
|
|
|
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
|
|
|
|
* `newDisplay` Object
|
|
|
|
|
|
|
|
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
|
|
|
|
* `oldDisplay` Object
|
|
|
|
|
|
|
|
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
|
|
|
|
* `display` Object
|
2015-05-15 20:09:59 +00:00
|
|
|
* `changedMetrics` Array
|
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
|
|
|
|
|
|
|
Returns the current absolute position of the mouse pointer.
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### `screen.getPrimaryDisplay()`
|
2014-01-07 12:35:13 +00:00
|
|
|
|
|
|
|
Returns 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
|
|
|
|
|
|
|
Returns an array of displays that are currently available.
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### `screen.getDisplayNearestPoint(point)`
|
2015-01-16 21:57:16 +00:00
|
|
|
|
2015-01-16 22:01:52 +00:00
|
|
|
* `point` Object
|
2015-01-16 21:57:16 +00:00
|
|
|
* `x` Integer
|
|
|
|
* `y` Integer
|
|
|
|
|
|
|
|
Returns the display nearest the specified point.
|
|
|
|
|
2015-08-29 05:24:54 +00:00
|
|
|
### `screen.getDisplayMatching(rect)`
|
2015-01-16 21:57:16 +00:00
|
|
|
|
|
|
|
* `rect` Object
|
|
|
|
* `x` Integer
|
|
|
|
* `y` Integer
|
|
|
|
* `width` Integer
|
|
|
|
* `height` Integer
|
|
|
|
|
|
|
|
Returns the display that most closely intersects the provided bounds.
|