screen

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

进程：主进程

此模块在 app 模块的 ready 事件发出之前无法使用。

screen 是一个 EventEmitter。

注意： 在渲染器/开发者工具中，window.screen 是一个保留的 DOM 属性，因此编写 let { screen } = require('electron') 将不起作用。

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

docs/fiddles/screen/fit-screen (34.0.0)在 Fiddle 中打开

main.js

// Retrieve information about screen size, displays, cursor position, etc.
//
// For more info, see:
// https://electron.js.cn/docs/latest/api/screen

const { app, BrowserWindow, screen } = require('electron/main')

let mainWindow = null

app.whenReady().then(() => {
  // 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://electron.js.cn')
})

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

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 模块发出以下事件

事件：'display-added'

返回

• event 事件
• newDisplay Display

当 newDisplay 已添加时发出。

事件：'display-removed'

返回

• event 事件
• oldDisplay Display

当 oldDisplay 已删除时发出。

事件：'display-metrics-changed'

返回

• 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 缩放是相对于包含 DIP 点的显示器执行的。

screen.screenToDipRect(window, rect) Windows

• window BrowserWindow | null
• rect Rectangle

返回 Rectangle

将屏幕物理矩形转换为屏幕 DIP 矩形。DPI 缩放是相对于最靠近 window 的显示器执行的。如果 window 为 null，则缩放将对最靠近 rect 的显示器执行。

screen.dipToScreenRect(window, rect) Windows

• window BrowserWindow | null
• rect Rectangle

返回 Rectangle

将屏幕 DIP 矩形转换为屏幕物理矩形。DPI 缩放是相对于最靠近 window 的显示器执行的。如果 window 为 null，则缩放将对最靠近 rect 的显示器执行。