screen · Electron 中文文檔

# screen `screen` 模塊檢索屏幕的 size，顯示，鼠標位置等的信息.在 `app` 模塊的`ready` 事件觸發之前不可使用這個模塊. `screen` 是一個 [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter). **注意:** 在渲染進程 / 開發者工具欄, `window.screen` 是一個預設值的 DOM 屬性, 所以這樣寫 `var screen = require('electron').screen` 將不會工作. 在我們下面的例子, 我們取代使用可變名字的 `electronScreen`. 一個例子，創建一個充滿真個屏幕的窗口 : ```javascript const electron = require('electron'); const app = electron.app; const BrowserWindow = electron.BrowserWindow; var mainWindow; app.on('ready', function() { var electronScreen = electron.screen; var size = electronScreen.getPrimaryDisplay().workAreaSize; mainWindow = new BrowserWindow({ width: size.width, height: size.height }); }); ``` 另一個例子，在次頁外創建一個窗口: ```javascript const electron = require('electron'); const app = electron.app; const BrowserWindow = electron.BrowserWindow; var mainWindow; app.on('ready', function() { var electronScreen = electron.screen; var displays = electronScreen.getAllDisplays(); var externalDisplay = null; for (var i in displays) { if (displays[i].bounds.x != 0 || displays[i].bounds.y != 0) { externalDisplay = displays[i]; break; } } if (externalDisplay) { mainWindow = new BrowserWindow({ x: externalDisplay.bounds.x + 50, y: externalDisplay.bounds.y + 50 }); } }); ``` ## `Display` 對象 `Display` 對象表示了物力方式連接系統. 一個偽造的 `Display` 或許存在于一個無頭系統中，或者一個 `Display` 相當于一個遠程的、虛擬的 display. * `display` object * `id` Integer - 與display 相關的唯一性標志. * `rotation` Integer - 可以是 0, 1, 2, 3, 每個代表了屏幕旋轉的度數 0, 90, 180, 270. * `scaleFactor` Number - Output device's pixel scale factor. * `touchSupport` String - 可以是 `available`, `unavailable`, `unknown`. * `bounds` Object * `size` Object * `workArea` Object * `workAreaSize` Object ## 事件 `screen` 模塊有如下事件: ### Event: 'display-added' 返回: * `event` Event * `newDisplay` Object 當添加了 `newDisplay` 時發出事件 ### Event: 'display-removed' 返回: * `event` Event * `oldDisplay` Object 當移出了 `oldDisplay` 時發出事件 ### Event: 'display-metrics-changed' 返回: * `event` Event * `display` Object * `changedMetrics` Array 當一個 `display` 中的一個或更多的 metrics 改變時發出事件. `changedMetrics` 是一個用來描述這個改變的數組.可能的變化為 `bounds`, `workArea`, `scaleFactor` 和 `rotation`. ## 方法 `screen` 模塊有如下方法: ### `screen.getCursorScreenPoint()` 返回當前鼠標的絕對路徑 . ### `screen.getPrimaryDisplay()` 返回最主要的 display. ### `screen.getAllDisplays()` 返回一個當前可用的 display 數組. ### `screen.getDisplayNearestPoint(point)` * `point` Object * `x` Integer * `y` Integer 返回離指定點最近的 display. ### `screen.getDisplayMatching(rect)` * `rect` Object * `x` Integer * `y` Integer * `width` Integer * `height` Integer 返回與提供的邊界范圍最密切相關的 display.