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

// Retrieve information about screen size, displays, cursor position, etc.
//
// For more info, see:
// https://electronjs.org/docs/api/screen
const { app, BrowserWindow } = require('electron')
let mainWindow = null
app.whenReady().then(() => {
  // We cannot require the screen module until the app is ready.
  const { screen } = require('electron')
  // Create a window that fills the screen's available work area.
  const primaryDisplay = screen.getPrimaryDisplay()
  const { width, height } = primaryDisplay.workAreaSize
  mainWindow = new BrowserWindow({ width, height })
  mainWindow.loadURL('https://electronjs.org')
})

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

const { app, BrowserWindow, screen } = require('electron')
let win
app.whenReady().then(() => {
  const displays = screen.getAllDisplays()
  const externalDisplay = displays.find((display) => {
    return display.bounds.x !== 0 || display.bounds.y !== 0
  })
  if (externalDisplay) {
    win = new BrowserWindow({
      x: externalDisplay.bounds.x + 50,
      y: externalDisplay.bounds.y + 50
    })
    win.loadURL('https://github.com')
  }
})

事件

screen模块触发以下事件:

Event: ‘display-added’

返回:

• event Event
• newDisplay Display

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

Event: ‘display-removed’

返回:

• event Event
• oldDisplay Display

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

Event: ‘display-metrics-changed’

返回:

• event Event
• display Display
• changedMetrics string[]

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

方法

screen模块有以下方法:

screen.getCursorScreenPoint()

返回 Point

当前鼠标的绝对位置。

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

screen.getPrimaryDisplay()

返回主窗口Display

screen.getAllDisplays()

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

screen.getDisplayNearestPoint(point)

• point Point

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

screen.getDisplayMatching(rect)

• rect Rectangle

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

screen.screenToDipPoint(point) Windows

• point Point

返回 Point

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

screen.dipToScreenPoint(point) Windows

• point Point

返回 Point

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

screen.screenToDipRect(window, rect) Windows

• window BrowserWindow | null
• rect Rectangle

返回 Rectangle

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

screen.dipToScreenRect(window, rect) Windows

• window BrowserWindow | null
• rect Rectangle

返回 Rectangle

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