Configuration

The window configuration class Boson\Window\WindowCreateInfo is optional and serves as a convenient way to define default settings for main window of your app.

#Title

Sets the title that appears in the window's title bar and taskbar.

$windowConfig = new Boson\Window\WindowCreateInfo( 
    title: 'My Application Window',
);

More information about window title can be found in the window documentation.

#Hardware Acceleration

Enables or disables hardware-accelerated rendering for better performance.

$windowConfig = new Boson\Window\WindowCreateInfo( 
    enableHardwareAcceleration: true, // Default is true
);

macOS/WebKit

Does not allow to control hardware-acceleration.

This configuration option has no effect.

#Window Size (Width and Height)

Defines the initial dimensions of the window in pixels.

$windowConfig = new Boson\Window\WindowCreateInfo( 
    width: 800,
    height: 600,
);

More information about window size can be found in the window documentation.

#Window Resizability

Determines if the window can be resized by the user.

$windowConfig = new Boson\Window\WindowCreateInfo( 
    resizable: true, // Default is true
);

#Window Visibility

Controls whether the window is initially visible when created.

$windowConfig = new Boson\Window\WindowCreateInfo( 
    visible: true, // Default is true
);

More information about window visibility can be found in the window documentation.

#Always On Top

Controls whether a window should stay on top of other windows.

$windowConfig = new Boson\Window\WindowCreateInfo(
    alwaysOnTop: true, // Default is false
);

Linux/GTK4

There is no way to artificially set window always on top.

This configuration option has no effect.

More information about window "always on top" feature can be found in the window documentation.

#Click Through

Enables or disables the window's handling of mouse events.

$windowConfig = new Boson\Window\WindowCreateInfo(
    clickThrough: true, // Default is false
);

More information about window "click-through" feature can be found in the window documentation.

#Window Decorations

Specifies the window's border, title bar style and other.

$windowConfig = new Boson\Window\WindowCreateInfo( 
    decoration: Boson\Window\WindowDecoration::Default,
);

More information about window decorations can be found in the window documentation.