-

  1. screen
 模块检索屏幕的 size,显示,鼠标位置等的信息.在 
  1. app
 模块的
  1. ready
 事件触发之前不可使用这个模块.

  1. screen
 是一个 EventEmitter.

注意: 在渲染进程 / 开发者工具栏, 

  1. window.screen
 是一个预设值的 DOM 属性, 所以这样写 
  1. var screen = require('electron').screen
 将不会工作. 在我们下面的例子, 我们取代使用可变名字的 
  1. electronScreen
. 一个例子,创建一个充满真个屏幕的窗口 :

  1. const electron = require('electron');
  2. const app = electron.app;
  3. const BrowserWindow = electron.BrowserWindow;
  4. var mainWindow;
  5. app.on('ready', function() {
  6. var electronScreen = electron.screen;
  7. var size = electronScreen.getPrimaryDisplay().workAreaSize;
  8. mainWindow = new BrowserWindow({ width: size.width, height: size.height });
  9. });

另一个例子,在次页外创建一个窗口:

  1. const electron = require('electron');
  2. const app = electron.app;
  3. const BrowserWindow = electron.BrowserWindow;
  4. var mainWindow;
  5. app.on('ready', function() {
  6. var electronScreen = electron.screen;
  7. var displays = electronScreen.getAllDisplays();
  8. var externalDisplay = null;
  9. for (var i in displays) {
  10. if (displays[i].bounds.x != 0 || displays[i].bounds.y != 0) {
  11. externalDisplay = displays[i];
  12. break;
  13. }
  14. }
  15. if (externalDisplay) {
  16. mainWindow = new BrowserWindow({
  17. x: externalDisplay.bounds.x + 50,
  18. y: externalDisplay.bounds.y + 50
  19. });
  20. }
  21. });

  1. Display
 对象

  1. Display
 对象表示了物力方式连接系统. 一个伪造的 
  1. Display
 或许存在于一个无头系统中,或者一个 
  1. Display
 相当于一个远程的、虚拟的 display.

    1. display
     object
      1. id
       Integer - 与display 相关的唯一性标志.
      1. rotation
       Integer - 可以是 0, 1, 2, 3, 每个代表了屏幕旋转的度数 0, 90, 180, 270.
      1. scaleFactor
       Number - Output device's pixel scale factor.
      1. touchSupport
       String - 可以是 
      1. available
      , 
      1. unavailable
      , 
      1. unknown
      .
      1. bounds
       Object
      1. size
       Object
      1. workArea
       Object
      1. workAreaSize
       Object

事件

  1. screen
 模块有如下事件:

Event: 'display-added'

返回:

    1. event
     Event
    1. newDisplay
     Object

当添加了 

  1. newDisplay
 时发出事件

Event: 'display-removed'

返回:

    1. event
     Event
    1. oldDisplay
     Object

当移出了 

  1. oldDisplay
 时发出事件

Event: 'display-metrics-changed'

返回:

    1. event
     Event
    1. display
     Object
    1. changedMetrics
     Array

当一个 

  1. display
 中的一个或更多的 metrics 改变时发出事件. 
  1. changedMetrics
 是一个用来描述这个改变的数组.可能的变化为 
  1. bounds
, 
  1. workArea
, 
  1. scaleFactor
  
  1. rotation
.

方法

  1. screen
 模块有如下方法:

  1. screen.getCursorScreenPoint()

返回当前鼠标的绝对路径 .

  1. screen.getPrimaryDisplay()

返回最主要的 display.

  1. screen.getAllDisplays()

返回一个当前可用的 display 数组.

  1. screen.getDisplayNearestPoint(point)

    1. point
     Object
      1. x
       Integer
      1. y
       Integer

返回离指定点最近的 display.

  1. screen.getDisplayMatching(rect)

    1. rect
     Object
      1. x
       Integer
      1. y
       Integer
      1. width
       Integer
      1. height
       Integer

返回与提供的边界范围最密切相关的 display.