Skip to main content

OverlayWindowOptions

Electron APIs / overlay / OverlayWindowOptions

Configuration options for an overlay window.

Used at creation time to define the overlay window's behavior and appearance. Extends:

  • Standard Electron BrowserWindowConstructorOptions.
  • Overlay specific behaviors using OverlayOptions.

Extends

Properties

PropertyTypeDescription
dpiAware?booleantrue—the overlay window will be DPI aware (Main monitor DPI). This allows the overlay to scale correctly on high DPI displays. Default false Since 1.7.0
enableHWAcceleration?booleanThis option is not currently supported and has no effect. It is reserved for future use.
enableIsolation?booleanEnables Chromium process isolation (sandboxing). Used to enforce stricter security policies or prevent resource sharing between renderer processes.
ignoreKeyboardInput?booleanControls whether the overlay intercepts keyboard input. true—the overlay won't intercept keyboard input. Default false
namestringUnique name (id) for the window.
passthrough?PassthroughTypeControls how input is handled by the overlay window. Default 'noPassThrough' See PassthroughType.
zOrder?ZOrderTypeControls the z-order (stacking order) of the overlay window. Default 'default' See ZOrderType.