Struct winit::WindowBuilder

pub struct WindowBuilder {
    pub window: WindowAttributes,
    /* private fields */
}

Object that allows you to build windows.

Fields

window: WindowAttributes

The attributes to use to create the window.

Implementations

impl WindowBuilder

pub fn new() -> WindowBuilder

Initializes a new WindowBuilder with default values.

pub fn with_dimensions(self, size: LogicalSize) -> WindowBuilder

Requests the window to be of specific dimensions.

pub fn with_min_dimensions(self, min_size: LogicalSize) -> WindowBuilder

Sets a minimum dimension size for the window

pub fn with_max_dimensions(self, max_size: LogicalSize) -> WindowBuilder

Sets a maximum dimension size for the window

pub fn with_resizable(self, resizable: bool) -> WindowBuilder

Sets whether the window is resizable or not

Note that making the window unresizable doesn’t exempt you from handling Resized, as that event can still be triggered by DPI scaling, entering fullscreen mode, etc.

Platform-specific

This only has an effect on desktop platforms.

Due to a bug in XFCE, this has no effect on Xfwm.

pub fn with_title<T: Into<String>>(self, title: T) -> WindowBuilder

Requests a specific title for the window.

pub fn with_fullscreen(self, monitor: Option<MonitorId>) -> WindowBuilder

Sets the window fullscreen state. None means a normal window, Some(MonitorId) means a fullscreen window on that specific monitor

pub fn with_maximized(self, maximized: bool) -> WindowBuilder

Requests maximized mode.

pub fn with_visibility(self, visible: bool) -> WindowBuilder

Sets whether the window will be initially hidden or visible.

pub fn with_transparency(self, transparent: bool) -> WindowBuilder

Sets whether the background of the window should be transparent.

pub fn with_decorations(self, decorations: bool) -> WindowBuilder

Sets whether the window should have a border, a title bar, etc.

pub fn with_always_on_top(self, always_on_top: bool) -> WindowBuilder

Sets whether or not the window will always be on top of other windows.

pub fn with_window_icon(self, window_icon: Option<Icon>) -> WindowBuilder

Sets the window icon. On Windows and X11, this is typically the small icon in the top-left corner of the titlebar.

Platform-specific

This only has an effect on Windows and X11.

On Windows, this sets ICON_SMALL. The base size for a window icon is 16x16, but it’s recommended to account for screen scaling and pick a multiple of that, i.e. 32x32.

X11 has no universal guidelines for icon sizes, so you’re at the whims of the WM. That said, it’s usually in the same ballpark as on Windows.

pub fn with_multitouch(self) -> WindowBuilder

Enables multitouch.

pub fn build(self, events_loop: &EventsLoop) -> Result<Window, CreationError>

Builds the window.

Error should be very rare and only occur in case of permission denied, incompatible system, out of memory, etc.

Trait Implementations

impl Clone for WindowBuilder

fn clone(&self) -> WindowBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WindowBuilder

fn fmt(&self, fmtr: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl WindowBuilderExt for WindowBuilder

fn with_x11_visual<T>(self, visual_infos: *const T) -> WindowBuilder

fn with_x11_screen(self, screen_id: i32) -> WindowBuilder

fn with_class(self, instance: String, class: String) -> WindowBuilder

Build window with WM_CLASS hint; defaults to the name of the binary. Only relevant on X11.

fn with_override_redirect(self, override_redirect: bool) -> WindowBuilder

Build window with override-redirect flag; defaults to false. Only relevant on X11.

fn with_x11_window_type(self, x11_window_type: XWindowType) -> WindowBuilder

Build window with _NET_WM_WINDOW_TYPE hint; defaults to Normal. Only relevant on X11.

fn with_resize_increments(self, increments: LogicalSize) -> WindowBuilder

Build window with resize increment hint. Only implemented on X11.

fn with_base_size(self, base_size: LogicalSize) -> WindowBuilder

Build window with base size hint. Only implemented on X11.

fn with_gtk_theme_variant(self, variant: String) -> WindowBuilder

Build window with _GTK_THEME_VARIANT hint set to the specified value. Currently only relevant on X11.

fn with_app_id(self, app_id: String) -> WindowBuilder

Build window with a given application ID. It should match the .desktop file distributed with your program. Only relevant on Wayland.