跳转到主要内容

screen

获取有关屏幕尺寸、显示器、光标位置等信息。

进程：主进程

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

screen 是一个 EventEmitter。

注意

在渲染器/DevTools 中，window.screen 是一个保留的 DOM 属性，因此使用 let { screen } = require('electron') 将不起作用。

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

docs/fiddles/screen/fit-screen (38.0.0)在 Fiddle 中打开
// 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')
  }
})
注意

此模块使用的屏幕坐标是 Point 结构。进程可用的坐标有两种类型：

  • 物理屏幕点 是显示器上的原始硬件像素。
  • 设备无关像素 (DIP) 点 是基于显示器 DPI（每英寸点数）缩放的虚拟化屏幕点。

事件​

screen 模块会发出以下事件：

事件：'display-added'​

返回

当添加了 newDisplay 时发出。

事件：'display-removed'​

返回

当删除了 oldDisplay 时发出。

事件：'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)​

返回 Display - 最接近给定点的显示器。

screen.getDisplayMatching(rect)​

返回 Display - 最接近提供的边界的显示器。

screen.screenToDipPoint(point) Windows Linux​

返回 Point

将物理屏幕点转换为 DIP 屏幕点。DPI 缩放是相对于包含该物理点的显示器进行的。

目前在 Wayland 上不支持 - 如果在该平台上使用，它将返回传入的点，不做任何更改。

screen.dipToScreenPoint(point) Windows Linux​

返回 Point

将 DIP 屏幕点转换为物理屏幕点。DPI 缩放是相对于包含该 DIP 点的显示器进行的。

目前在 Wayland 上不支持。

screen.screenToDipRect(window, rect) Windows​

返回 Rectangle

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

screen.dipToScreenRect(window, rect) Windows​

返回 Rectangle

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