screen.md

screen

Recuperar información acerca del tamaño de la pantalla, posiciones del cursor, posiciones, etc.

Proceso: principal</0>

Este módulo no puede ser usado hasta que el evento ready del módulo app es emitido.

screen es un EventEmitter.

Nota: En el renderer / DevTools, window.screen propiedad reservada DOM, así que escribir let { screen } = require('electron') no funcionará.

Un ejemplo de crear una ventana que llene toda la pantalla:

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

let win
app.whenReady().then(() => {
  const { width, height } = screen.getPrimaryDisplay().workAreaSize
  win = new BrowserWindow({ width, height })
  win.loadURL('https://github.com/')
})

Otro ejemplo de crear una ventana el display externo es:

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/')
  }
})

Eventos

El módulo screen emite los siguientes eventos:

Evento: 'display-added'

Devuelve:

• event
• newDisplay Display

Emitido cuando newDisplay ha sido añadido.

Evento: 'display-removed'

Devuelve:

• event
• oldDisplay Display

Emitido cuando oldDisplay ha sido eliminado.

Evento: 'display-metrics-changed'

Devuelve:

• event
• display Display
• changedMetrics Cadena[]

Emitido cuando o más métricos cambian en un display. El changedMetrics es un arreglo de cadenas que describen los cambios. Posibles cambios son bounds, workArea, scaleFactor y rotation.

Métodos

El módulo screen tiene los siguientes métodos:

screen.getCursorScreenPoint()

Devuelve Point

La actual y absoluta posición del cursor del mouse.

Nota: El valor devuelto es un punto DIP, no una punto físico de la pantalla.

screen.getPrimaryDisplay()

Devuelve Display - La muestra primaria.

screen.getAllDisplays()

Devuelve Display[] - Un arreglo de muestras que son actualmente disponibles.

screen.getDisplayNearestPoint(point)

• point Point

Devuelve Display - La muestra más cerca del punto especificado.

screen.getDisplayMatching(rect)

• rect Rectangle

Devuelve Display - La muestra que es más cercana intersecta a las bandas dadas.

screen.screenToDipPoint(point) Windows

• point Point

Devuelve Point

Convierte un punto físico en la pantalla a un punto DIP de la pantalla. La escala DPI se realiza en relación a la pantalla que contiene el punto físico.

screen.dipToScreenPoint(point) Windows

• point Point

Devuelve Point

Convierte un punto DIP de pantalla a un punto físico de la pantalla. La escala DPI se realiza en relación a la pantalla que contiene el punto DIP.

screen.screenToDipRect(window, rect) Windows

• window BrowserWindow | null
• rect Rectangle

Devuelve Rectangle

Convierte una rect física de pantalla a una rect DIP de pantalla. La escala DPI se realiza en relación a la pantalla más cercana a window. Si window es nulo, el escalamiento se realizará a la pantalla mas cercana a rect.

screen.dipToScreenRect(window, rect) Windows

• window BrowserWindow | null
• rect Rectangle

Devuelve Rectangle

Convierte una pantalla DIP rect a una rect física de pantalla. La escala DPI se realiza en relación a la pantalla más cercana a window. Si window es nulo, el escalamiento se realizará a la pantalla mas cercana a rect.