PooledWindowProps

Defined in: renderer/PooledWindow.tsx:122

Extends

• Omit<BaseWindowProps, PoolExcludedProps>

Properties

alwaysOnTop?

optional alwaysOnTop: boolean | AlwaysOnTopLevel

Defined in: shared/types.ts:432

Whether the window should always be on top.

Inherited from

WindowProps.alwaysOnTop

---

backgroundColor?

optional backgroundColor: string

Defined in: shared/types.ts:402

Background color

Inherited from

WindowProps.backgroundColor

---

center?

optional center: boolean

Defined in: shared/types.ts:370

Center the window on creation. Default: true if no x/y specified.

Inherited from

WindowProps.center

---

children

children: ReactNode

Defined in: renderer/PooledWindow.tsx:126

Content to render inside the window

---

closable?

optional closable: boolean

Defined in: shared/types.ts:310

Whether the user can close the window. Default: true. When false, the close button is hidden/disabled.

Inherited from

WindowProps.closable

---

defaultHeight?

optional defaultHeight: number

Defined in: shared/types.ts:318

Initial height. Only applied on window creation.

Inherited from

WindowProps.defaultHeight

---

defaultWidth?

optional defaultWidth: number

Defined in: shared/types.ts:315

Initial width. Only applied on window creation.

Inherited from

WindowProps.defaultWidth

---

defaultX?

optional defaultX: number

Defined in: shared/types.ts:321

Initial x position. Only applied on window creation.

Inherited from

WindowProps.defaultX

---

defaultY?

optional defaultY: number

Defined in: shared/types.ts:324

Initial y position. Only applied on window creation.

Inherited from

WindowProps.defaultY

---

focusable?

optional focusable: boolean

Defined in: shared/types.ts:429

Whether the window is focusable. Default: true.

Inherited from

WindowProps.focusable

---

fullscreen?

optional fullscreen: boolean

Defined in: shared/types.ts:443

Enter/exit fullscreen mode

Inherited from

WindowProps.fullscreen

---

fullscreenable?

optional fullscreenable: boolean

Defined in: shared/types.ts:446

Whether the window can enter fullscreen. Default: true.

Inherited from

WindowProps.fullscreenable

---

height?

optional height: number

Defined in: shared/types.ts:338

Controlled height. Changes will resize the window. Use with onBoundsChange for two-way sync.

Inherited from

WindowProps.height

---

ignoreMouseEvents?

optional ignoreMouseEvents: boolean

Defined in: shared/types.ts:454

Ignore mouse events (click-through window)

Inherited from

WindowProps.ignoreMouseEvents

---

maxHeight?

optional maxHeight: number

Defined in: shared/types.ts:367

Maximum height constraint

Inherited from

WindowProps.maxHeight

---

maximizable?

optional maximizable: boolean

Defined in: shared/types.ts:426

Whether the window can be maximized. Default: true.

Inherited from

WindowProps.maximizable

---

maxWidth?

optional maxWidth: number

Defined in: shared/types.ts:361

Maximum width constraint

Inherited from

WindowProps.maxWidth

---

minHeight?

optional minHeight: number

Defined in: shared/types.ts:364

Minimum height constraint

Inherited from

WindowProps.minHeight

---

minimizable?

optional minimizable: boolean

Defined in: shared/types.ts:423

Whether the window can be minimized. Default: true.

Inherited from

WindowProps.minimizable

---

minWidth?

optional minWidth: number

Defined in: shared/types.ts:358

Minimum width constraint

Inherited from

WindowProps.minWidth

---

movable?

optional movable: boolean

Defined in: shared/types.ts:420

Whether the window is movable. Default: true.

Inherited from

WindowProps.movable

---

name?

optional name: string

Defined in: shared/types.ts:484

Debug name for DevTools and error messages. Useful for identifying windows in multi-window apps.

Inherited from

WindowProps.name

---

onBlur()?

optional onBlur: () => void

Defined in: shared/types.ts:525

Fired when the window loses focus

Returns

void

Inherited from

WindowProps.onBlur

---

onBoundsChange()?

optional onBoundsChange: (bounds) => void

Defined in: shared/types.ts:353

Callback fired when window bounds change (resize or move). Debounced internally.

Parameters

bounds

Bounds

Returns

void

Inherited from

WindowProps.onBoundsChange

---

onClose()?

optional onClose: () => void

Defined in: shared/types.ts:528

Fired when the window is destroyed (for any reason — user close, programmatic, unmount)

Returns

void

Inherited from

WindowProps.onClose

---

onDisplayChange()?

optional onDisplayChange: (display) => void

Defined in: shared/types.ts:537

Fired when window moves to a different display

Parameters

display

DisplayInfo

Returns

void

Inherited from

WindowProps.onDisplayChange

---

onEnterFullscreen()?

optional onEnterFullscreen: () => void

Defined in: shared/types.ts:531

Fired when window enters fullscreen

Returns

void

Inherited from

WindowProps.onEnterFullscreen

---

onExitFullscreen()?

optional onExitFullscreen: () => void

Defined in: shared/types.ts:534

Fired when window exits fullscreen (maps to Electron’s ‘leave-full-screen’ event)

Returns

void

Inherited from

WindowProps.onExitFullscreen

---

onFocus()?

optional onFocus: () => void

Defined in: shared/types.ts:522

Fired when the window gains focus

Returns

void

Inherited from

WindowProps.onFocus

---

onMaximize()?

optional onMaximize: () => void

Defined in: shared/types.ts:510

Fired when window is maximized

Returns

void

Inherited from

WindowProps.onMaximize

---

onMinimize()?

optional onMinimize: () => void

Defined in: shared/types.ts:516

Fired when window is minimized

Returns

void

Inherited from

WindowProps.onMinimize

---

onReady()?

optional onReady: () => void

Defined in: shared/types.ts:507

Fired when window is ready and content is mounted

Returns

void

Inherited from

WindowProps.onReady

---

onRestore()?

optional onRestore: () => void

Defined in: shared/types.ts:519

Fired when window is restored from minimized

Returns

void

Inherited from

WindowProps.onRestore

---

onUnmaximize()?

optional onUnmaximize: () => void

Defined in: shared/types.ts:513

Fired when window is unmaximized

Returns

void

Inherited from

WindowProps.onUnmaximize

---

onUserClose()?

optional onUserClose: () => void

Defined in: shared/types.ts:304

Called when the user initiates a close (e.g., clicks the X button).

Fires during Electron’s close event — the window is about to close but hasn’t yet. Use this to sync your open state back to false. The window will close on its own; your open={false} is for your state consistency, not to drive the close.

This is a notification, not an interceptor. To prevent close, set closable={false} proactively (e.g., closable={!hasUnsavedChanges}).

onClose (a separate callback) fires after the window is fully destroyed, for any reason (user, programmatic, unmount).

Returns

void

Inherited from

WindowProps.onUserClose

---

opacity?

optional opacity: number

Defined in: shared/types.ts:405

Window opacity (0.0 to 1.0)

Inherited from

WindowProps.opacity

---

open

open: boolean

Defined in: shared/types.ts:288

Whether the window should be open/visible. When true, the window is created/shown. When false, the window is destroyed.

Inherited from

WindowProps.open

---

pool

pool: WindowPoolDefinition

Defined in: renderer/PooledWindow.tsx:124

Pool to acquire windows from

---

resizable?

optional resizable: boolean

Defined in: shared/types.ts:417

Whether the window is resizable. Default: true.

Inherited from

WindowProps.resizable

---

showInactive?

optional showInactive: boolean

Defined in: shared/types.ts:451

Show window without stealing focus

Inherited from

WindowProps.showInactive

---

skipTaskbar?

optional skipTaskbar: boolean

Defined in: shared/types.ts:438

Whether to skip showing in taskbar/dock.

Inherited from

WindowProps.skipTaskbar

---

title?

optional title: string

Defined in: shared/types.ts:375

Window title

Inherited from

WindowProps.title

---

titleBarOverlay?

optional titleBarOverlay: TitleBarOverlayOptions

Defined in: shared/types.ts:465

Title bar overlay options (Windows)

Inherited from

WindowProps.titleBarOverlay

---

trafficLightPosition?

optional trafficLightPosition: object

Defined in: shared/types.ts:462

Traffic light (close/minimize/maximize) button position (macOS)

x

x: number

y

y: number

Inherited from

WindowProps.trafficLightPosition

---

visible?

optional visible: boolean

Defined in: shared/types.ts:414

Whether the window is visible. Default: true. Set to false to hide the window without destroying it (state is preserved). Unlike open, which controls the window’s existence, visible controls whether it’s shown.

Inherited from

WindowProps.visible

---

visibleOnAllWorkspaces?

optional visibleOnAllWorkspaces: boolean

Defined in: shared/types.ts:457

Visible on all workspaces/virtual desktops

Inherited from

WindowProps.visibleOnAllWorkspaces

---

width?

optional width: number

Defined in: shared/types.ts:332

Controlled width. Changes will resize the window. Use with onBoundsChange for two-way sync.

Inherited from

WindowProps.width

---

x?

optional x: number

Defined in: shared/types.ts:344

Controlled x position. Changes will move the window. Use with onBoundsChange for two-way sync.

Inherited from

WindowProps.x

---

y?

optional y: number

Defined in: shared/types.ts:350

Controlled y position. Changes will move the window. Use with onBoundsChange for two-way sync.

Inherited from

WindowProps.y