screen

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

screen 是一个 EventEmitter.

注意: 在渲染进程 / 开发者工具栏, window.screen 是一个预设值的 DOM属性, 所以这样写 var screen = require('electron').screen 将不会工作.在我们下面的例子, 我们取代使用可变名字的 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. });

Display 对象

Display 对象表示一个连接到系统的物理显示. 一个虚设的 Display 或许存在于一个无头系统(headless system)中,或者一个 Display 对应一个远程的、虚拟的display.

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

事件

screen 模块有如下事件:

Event: 'display-added'

返回:

  • event Event
  • newDisplay Object
    当添加了 newDisplay 时发出事件

Event: 'display-removed'

返回:

  • event Event
  • oldDisplay Object
    当移出了 oldDisplay 时发出事件

Event: 'display-metrics-changed'

返回:

  • event Event
  • display Object
  • changedMetrics Array
    当一个 display 中的一个或更多的 metrics 改变时发出事件.changedMetrics 是一个用来描述这个改变的数组.可能的变化为 bounds,workArea, scaleFactorrotation.

方法

screen 模块有如下方法:

screen.getCursorScreenPoint()

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

screen.getPrimaryDisplay()

返回最主要的 display.

screen.getAllDisplays()

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

screen.getDisplayNearestPoint(point)

  • point Object
    • x Integer
    • y Integer
      返回离指定点最近的 display.

screen.getDisplayMatching(rect)

  • rect Object
    • x Integer
    • y Integer
    • width Integer
    • height Integer
      返回与提供的边界范围最密切相关的 display.