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
objectid
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
Objectsize
ObjectworkArea
ObjectworkAreaSize
Object
事件
display-added
- 返回:
event
EventnewDisplay
Object
- 当添加了
newDisplay
时发出事件
display-removed
- 返回:
event
EventoldDisplay
Object
- 当移出了
oldDisplay
时发出事件
display-metrics-changed
- 返回:
event
Eventdisplay
ObjectchangedMetrics
Array
- 当一个
display
中的一个或更多的 metrics 改变时发出事件.changedMetrics
是一个用来描述这个改变的数组.可能的变化为bounds
,workArea
,scaleFactor
和rotation
.
方法
screen.getCursorScreenPoint()
返回当前鼠标的绝对路径 .
screen.getPrimaryDisplay()
返回最主要的 display.
screen.getAllDisplays()
返回一个当前可用的 display 数组.
screen.getDisplayNearestPoint(point)
point
Objectx
Integery
Integer
- 返回离指定点最近的 display.
screen.getDisplayMatching(rect)
rect
Objectx
Integery
Integerwidth
Integerheight
Integer
- 返回与提供的边界范围最密切相关的 display.
下一节:shell 模块提供了集成其他桌面客户端的关联功能.