screen

检索有关屏幕大小、显示器、光标位置等的信息。

进程:主进程

app 模块 emitted ready 事件之前,您不能使用此模块。

screen是一个EventEmitter.

注意: 在 renderer/DevTools 中, window.screen 是一个保留的 DOM 属性, 因此编写 let { screen } = require('electron') 将不起作用。

创建填充整个屏幕的窗口的示例:

docs/fiddles/screen/fit-screen (23.0.0)Open in Fiddle

  • main.js
  1. // Retrieve information about screen size, displays, cursor position, etc.
  2. //
  3. // For more info, see:
  4. // https://electronjs.org/docs/api/screen
  5. const { app, BrowserWindow } = require('electron')
  6. let mainWindow = null
  7. app.whenReady().then(() => {
  8. // We cannot require the screen module until the app is ready.
  9. const { screen } = require('electron')
  10. // Create a window that fills the screen's available work area.
  11. const primaryDisplay = screen.getPrimaryDisplay()
  12. const { width, height } = primaryDisplay.workAreaSize
  13. mainWindow = new BrowserWindow({ width, height })
  14. mainWindow.loadURL('https://electronjs.org')
  15. })

另一个在外部显示器中创建窗口的例子

  1. const { app, BrowserWindow, screen } = require('electron')
  2. let win
  3. app.whenReady().then(() => {
  4. const displays = screen.getAllDisplays()
  5. const externalDisplay = displays.find((display) => {
  6. return display.bounds.x !== 0 || display.bounds.y !== 0
  7. })
  8. if (externalDisplay) {
  9. win = new BrowserWindow({
  10. x: externalDisplay.bounds.x + 50,
  11. y: externalDisplay.bounds.y + 50
  12. })
  13. win.loadURL('https://github.com')
  14. }
  15. })

事件

screen模块触发以下事件:

Event: ‘display-added’

返回:

当新的窗口newDisplay被添加的时候触发。

Event: ‘display-removed’

返回:

当旧的窗口oldDisplay被移除的时候触发。

Event: ‘display-metrics-changed’

返回:

  • event Event
  • display Display
  • changedMetrics string[]

display中的一个或多个值发生改变时发出。 changedMetrics是描述更改信息的字符串数组。 可能改变的值有bounds, workArea, scaleFactorrotation.

方法

screen模块有以下方法:

screen.getCursorScreenPoint()

返回 Point

当前鼠标的绝对位置。

注意: 返回值是一个 DIP 点,而不是屏幕物理点。

screen.getPrimaryDisplay()

返回主窗口Display

screen.getAllDisplays()

返回一个窗口数组Display[],表示当前可用的窗口。

screen.getDisplayNearestPoint(point)

返回离指定点最近的一个窗口Display

screen.getDisplayMatching(rect)

返回离指定的图形最密切相交一个窗口Display

screen.screenToDipPoint(point) Windows

返回 Point

将屏幕物理点转换为屏幕DIP点。 相对于物理点的显示执行DPI缩放

screen.dipToScreenPoint(point) Windows

返回 Point

将屏幕DIP点转换为屏幕物理点。 相对于DPI的显示关系执行缩放

screen.screenToDipRect(window, rect) Windows

返回 Rectangle

将屏幕物理矩阵转换为屏幕DIP矩阵。 相对最近于 window 的显示来执行DPI缩放。 如果 window 为空,将执行缩放到最近的 rect 的显示位置。

screen.dipToScreenRect(window, rect) Windows

返回 Rectangle

将屏幕DIP矩阵转换为屏幕物理矩阵。 相对最近于 window 的显示来执行DPI缩放。 如果 window 为空,将执行缩放到最近的 rect 的显示位置。