mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions 1

Standardize screen

Browse source
This commit is contained in:
Jessica Lord 2015-08-28 22:24:54 -07:00
parent 50736296a7
commit e6e09a8a7c
1 changed files with 29 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

41
docs/api/screen.md
View file

@ -1,11 +1,14 @@
# screen # screen
Gets various info about screen size, displays, cursor position, etc. You should The `screen` module retrieves information about screen size, displays, cursor
not use this module until the `ready` event of `app` module gets emitted. position, etc. You should not use this module until the `ready` event of the
`app` module is emitted.
`screen` is an [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter). `screen` is an [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter).
Make sure to note that in the renderer / DevTools, `window.screen` is a reserved DOM property, so writing `screen = require('screen')` won't work. In our examples below, we use `atomScreen` as the variable name instead. **Note**: In the renderer / DevTools, `window.screen` is a reserved
DOM property, so writing `var screen = require('screen')` will not work. In our
examples below, we use `atomScreen` as the variable name instead.
An example of creating a window that fills the whole screen: An example of creating a window that fills the whole screen:
@ -50,43 +53,57 @@ app.on('ready', function() {
}); });
``` ```
## Event: display-added ## Events
The `screen` module emits the following events:
### Event: 'display-added'
Returns:
* `event` Event * `event` Event
* `newDisplay` Object * `newDisplay` Object
Emitted when `newDisplay` has been added. Emitted when `newDisplay` has been added.
## Event: display-removed ### Event: 'display-removed'
Returns:
* `event` Event * `event` Event
* `oldDisplay` Object * `oldDisplay` Object
Emitted when `oldDisplay` has been removed. Emitted when `oldDisplay` has been removed.
## Event: display-metrics-changed ### Event: 'display-metrics-changed'
Returns:
* `event` Event * `event` Event
* `display` Object * `display` Object
* `changedMetrics` Array * `changedMetrics` Array
Emitted when a `display` has one or more metrics changed, `changedMetrics` is Emitted when one or more metrics change in a `display`. The `changedMetrics` is
an array of strings that describe the changes. Possible changes are `bounds`, an array of strings that describe the changes. Possible changes are `bounds`,
`workArea`, `scaleFactor` and `rotation`. `workArea`, `scaleFactor` and `rotation`.
## screen.getCursorScreenPoint() ## Methods
The `screen` module has the following methods:
### `screen.getCursorScreenPoint()`
Returns the current absolute position of the mouse pointer. Returns the current absolute position of the mouse pointer.
## screen.getPrimaryDisplay() ### `screen.getPrimaryDisplay()`
Returns the primary display. Returns the primary display.
## screen.getAllDisplays() ### `screen.getAllDisplays()`
Returns an array of displays that are currently available. Returns an array of displays that are currently available.
## screen.getDisplayNearestPoint(point) ### `screen.getDisplayNearestPoint(point)`
* `point` Object * `point` Object
* `x` Integer * `x` Integer
@ -94,7 +111,7 @@ Returns an array of displays that are currently available.
Returns the display nearest the specified point. Returns the display nearest the specified point.
## screen.getDisplayMatching(rect) ### `screen.getDisplayMatching(rect)`
* `rect` Object * `rect` Object
* `x` Integer * `x` Integer