screen | Electron
https://www.electronjs.org/ja/docs/latest/api/screen • 62 KB fetched Open original page
screen | Electron
メインコンテンツへ飛ぶ
Electron ドキュメント API ブログ ツール
* Electron Forge
* Electron Fiddle
コミュニティ
* ガバナンス
* 事例紹介
* リソース
リリース 日本語
* English
* Deutsch
* Español
* Français
* 日本語
* Português
* Русский
* 中文
検索
* メインプロセスモジュール
* app
* autoUpdater
* BaseWindow
* BrowserView
* Deprecated
* BrowserWindow
* clipboard
* contentTracing
* crashReporter
* desktopCapturer
* dialog
* globalShortcut
* ImageView
* inAppPurchase
* ipcMain
* Menu
* MenuItem
* MessageChannelMain
* MessagePortMain
* nativeImage
* nativeTheme
* net
* netLog
* Notification
* powerMonitor
* powerSaveBlocker
* process
* protocol
* pushNotifications
* safeStorage
* screen
* session
* sharedTexture
* ShareMenu
* shell
* systemPreferences
* TouchBar
* Tray
* utilityProcess
* webContents
* WebContentsView
* webFrameMain
* 表示
* レンダラープロセスモジュール
* Utility Process Modules
* カスタム DOM 要素
* Chromium と Node.js
* クラス
* API の構造体
*
* メインプロセスモジュール
* screen 目次
screen
画面サイズ、ディスプレイ、カーソルの位置などについての情報を取得します。
プロセス: メイン
app モジュールの ready イベントが発生するまでは、このモジュールは使用できません。
screen は EventEmitter です。
[!NOTE] レンダラー / 開発者向けツールでは、 window.screen は予約済みの DOM プロパティなので、 let { screen } = require('electron') と書くことはできません。
以下は画面全体を埋めるウインドウを作成する例です。
docs/fiddles/screen/fit-screen ( 43.4.0 ) Open in Fiddle
* main.js // Retrieve information about screen size, displays, cursor position, etc.
//
// For more info, see:
// https://www.electronjs.org/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://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' )
}
} )
[!NOTE] このモジュールで使用される画面の座標は、 Point 構造体です。 この処理で使用できる座標は以下の 2 種類です。
* 物理画面ポイント 。ディスプレイ上の生のハードウェアピクセルです。
* デバイス非依存ピクセル (DIP) ポイント 。ディスプレイの DPI (ドット毎インチ) に基づいてスケールされた仮想画面ポイントです。
イベント
screen モジュールには以下のイベントがあります。
イベント: 'display-added'
戻り値:
* event Event
* newDisplay Display
newDisplay が追加されたときに発生します。
イベント: 'display-removed'
戻り値:
* event Event
* oldDisplay Display
oldDisplay が削除されたときに発生します。
イベント: 'display-metrics-changed'
戻り値:
* event Event
* display Display
* changedMetrics string[]
display 内の一つ以上の寸法が変化したときに発生します。 changedMetrics は、変化を示す文字列の配列です。 取りうる変化は bounds 、 workArea 、 scaleFactor 、 rotation です。
メソッド
screen モジュールには以下のメソッドがあります。
screen.getCursorScreenPoint()
戻り値 Point
マウスポインタの現在の絶対位置。
Wayland (Linux) ではサポートされていません。
[!NOTE] 戻り値は DIP ポイント単位です。画面の物理ポイント単位ではありません。
screen.getPrimaryDisplay()
戻り値 Display - プライマリディスプレイ。
screen.getAllDisplays()
戻り値 Display[] - 現在利用可能なディスプレイの配列。
screen.getDisplayNearestPoint(point)
* point Point
戻り値 Display - 指定した点に最も近い display。
screen.getDisplayMatching(rect)
* rect Rectangle
戻り値 Display - 指定された領域に最も交わるディスプレイ。
screen.screenToDipPoint(point) Windows Linux
* point Point
戻り値 Point
スクリーン上の物理的な点をスクリーン上の DIP な点に変換します。 DPI スケールは、物理的な点のあるディスプレイに対して相対的なものになります。
Wayland では現在サポートされていません。Wayland で使用すると、渡された点をそのまま返されます。
screen.dipToScreenPoint(point) Windows Linux
* point Point
戻り値 Point
スクリーン上の DIP な点をスクリーン上の物理的な点に変換します。 DPI スケールは、その DIP の点を含むディスプレイに対して相対的なものになります。
Wayland では現在サポートされていません。
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 に近いディスプレイで相対的に計算されます。
このページを編集
前
safeStorage
次
session
* イベント
* イベント: 'display-added'
* イベント: 'display-removed'
* イベント: 'display-metrics-changed'
* メソッド
* getCursorScreenPoint
* getPrimaryDisplay
* getAllDisplays
* getDisplayNearestPoint
* getDisplayMatching
* screenToDipPoint
* dipToScreenPoint
* screenToDipRect
* dipToScreenRect
ドキュメント
* 始めましょう
* API リファレンス
チェックリスト
* パフォーマンス
* セキュリティ
ツール
* Electron Forge
* Electron Fiddle
コミュニティ
* ガバナンス
* リソース
* Discord
* Bluesky
* X
* Mastodon
* Stack Overflow
その他
* GitHub
* Open Collective
* Infrastructure Dashboard
Copyright OpenJS Foundation and Electron contributors. All rights reserved. The OpenJS Foundation has registered trademarks and uses trademarks. For a list of trademarks of the OpenJS Foundation , please see our Trademark Policy and Trademark List . Trademarks and logos not indicated on the list of OpenJS Foundation trademarks are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them. The OpenJS Foundation | Terms of Use | Privacy Policy | Bylaws | Code of Conduct | Trademark Policy | Trademark List | Cookie Policy
Hosting and infrastructure graciously provided by
Links found on this page
- メインコンテンツへ飛ぶ [direct]
- Electron [direct]
- ドキュメント [direct]
- API [direct]
- ブログ [direct]
- Electron Forge [direct]
- Electron Fiddle [direct]
- ガバナンス [direct]
- 事例紹介 [direct]
- リソース [direct]
- リリース [direct]
- English [direct]
- Deutsch [direct]
- Español [direct]
- Français [direct]
- Português [direct]
- Русский [direct]
- 中文 [direct]
- autoUpdater [direct]
- BaseWindow [direct]
- BrowserView Deprecated [direct]
- BrowserWindow [direct]
- clipboard [direct]
- contentTracing [direct]
- crashReporter [direct]
- desktopCapturer [direct]
- dialog [direct]
- globalShortcut [direct]
- ImageView [direct]
- inAppPurchase [direct]
- ipcMain [direct]
- Menu [direct]
- MenuItem [direct]
- MessageChannelMain [direct]
- MessagePortMain [direct]
- nativeImage [direct]
- nativeTheme [direct]
- net [direct]
- netLog [direct]
- Notification [direct]
- powerMonitor [direct]
- powerSaveBlocker [direct]
- process [direct]
- protocol [direct]
- pushNotifications [direct]
- safeStorage [direct]
- session [direct]
- sharedTexture [direct]
- ShareMenu [direct]
- shell [direct]
- systemPreferences [direct]
- TouchBar [direct]
- Tray [direct]
- utilityProcess [direct]
- webContents [direct]
- WebContentsView [direct]
- webFrameMain [direct]
- 表示 [direct]
- カスタム DOM 要素 [direct]
- Chromium と Node.js [direct]
- クラス [direct]
- API の構造体 [direct]
- メイン [direct]
- EventEmitter [direct]
- docs/fiddles/screen/fit-screen ( 43.4.0 ) [direct]
- Open in Fiddle [direct]
- Point [direct]
- Display [direct]
- Point [direct]
- Rectangle [direct]
- このページを編集 [direct]
- パフォーマンス [direct]
- セキュリティ [direct]
- Discord [direct]
- Bluesky [direct]
- X [direct]
- Mastodon [direct]
- Stack Overflow [direct]
- GitHub [direct]
- Open Collective [direct]
|
|