screen 模块检索屏幕的 size,显示,鼠标位置等的信息.在 app 模块的ready 事件触发之前不可使用这个模块.
screen 是一个 EventEmitter.
注意: 在渲染进程 / 开发者工具栏, window.screen 是一个预设值的 DOM 属性, 所以这样写 var screen = require('electron').screen 将不会工作. 在我们下面的例子, 我们取代使用可变名字的 electronScreen. 一个例子,创建一个充满真个屏幕的窗口 :
const electron = require('electron');const app = electron.app;const BrowserWindow = electron.BrowserWindow;var mainWindow; app.on('ready', function() { var electronScreen = electron.screen; var size = electronScreen.getPrimaryDisplay().workAreaSize; mainWindow = new BrowserWindow({ width: size.width, height: size.height }); });
另一个例子,在次页外创建一个窗口:
const electron = require('electron');const app = electron.app;const BrowserWindow = electron.BrowserWindow;var mainWindow; app.on('ready', function() { var electronScreen = electron.screen; var displays = electronScreen.getAllDisplays(); var externalDisplay = null; for (var i in displays) { if (displays[i].bounds.x != 0 || displays[i].bounds.y != 0) { externalDisplay = displays[i]; break; } } if (externalDisplay) { mainWindow = new BrowserWindow({ x: externalDisplay.bounds.x + 50, y: externalDisplay.bounds.y + 50 }); } });
Display 对象
Display 对象表示了物力方式连接系统. 一个伪造的 Display 或许存在于一个无头系统中,或者一个 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, scaleFactor 和 rotation.
方法
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.