Struct winit::window::WindowBuilder
source · [−]pub struct WindowBuilder { /* private fields */ }
Expand description
Object that allows building windows.
Implementations
sourceimpl WindowBuilder
impl WindowBuilder
sourcepub fn with_inner_size<S: Into<Size>>(self, size: S) -> Self
pub fn with_inner_size<S: Into<Size>>(self, size: S) -> Self
Requests the window to be of specific dimensions.
If this is not set, some platform-specific dimensions will be used.
See Window::set_inner_size
for details.
sourcepub fn with_min_inner_size<S: Into<Size>>(self, min_size: S) -> Self
pub fn with_min_inner_size<S: Into<Size>>(self, min_size: S) -> Self
Sets the minimum dimensions a window can have.
If this is not set, the window will have no minimum dimensions (aside from reserved).
See Window::set_min_inner_size
for details.
sourcepub fn with_max_inner_size<S: Into<Size>>(self, max_size: S) -> Self
pub fn with_max_inner_size<S: Into<Size>>(self, max_size: S) -> Self
Sets the maximum dimensions a window can have.
If this is not set, the window will have no maximum or will be set to the primary monitor’s dimensions by the platform.
See Window::set_max_inner_size
for details.
sourcepub fn with_position<P: Into<Position>>(self, position: P) -> Self
pub fn with_position<P: Into<Position>>(self, position: P) -> Self
Sets a desired initial position for the window.
If this is not set, some platform-specific position will be chosen.
See Window::set_outer_position
for details.
Platform-specific
- macOS: The top left corner position of the window content, the
window’s “inner” position. The window title bar will be placed above
it. The window will be positioned such that it fits on screen,
maintaining set
inner_size
if any. If you need to precisely position the top left corner of the whole window you have to useWindow::set_outer_position
after creating the window. - Windows: The top left corner position of the window title bar, the window’s “outer” position. There may be a small gap between this position and the window due to the specifics of the Window Manager.
- X11: The top left corner of the window, the window’s “outer” position.
- Others: Ignored.
sourcepub fn with_resizable(self, resizable: bool) -> Self
pub fn with_resizable(self, resizable: bool) -> Self
Sets whether the window is resizable or not.
The default is true
.
See Window::set_resizable
for details.
sourcepub fn with_title<T: Into<String>>(self, title: T) -> Self
pub fn with_title<T: Into<String>>(self, title: T) -> Self
Sets the initial title of the window in the title bar.
The default is "winit window"
.
See Window::set_title
for details.
sourcepub fn with_fullscreen(self, fullscreen: Option<Fullscreen>) -> Self
pub fn with_fullscreen(self, fullscreen: Option<Fullscreen>) -> Self
Sets whether the window should be put into fullscreen upon creation.
The default is None
.
See Window::set_fullscreen
for details.
sourcepub fn with_maximized(self, maximized: bool) -> Self
pub fn with_maximized(self, maximized: bool) -> Self
Request that the window is maximized upon creation.
The default is false
.
See Window::set_maximized
for details.
sourcepub fn with_visible(self, visible: bool) -> Self
pub fn with_visible(self, visible: bool) -> Self
Sets whether the window will be initially visible or hidden.
The default is to show the window.
See Window::set_visible
for details.
sourcepub fn with_transparent(self, transparent: bool) -> Self
pub fn with_transparent(self, transparent: bool) -> Self
Sets whether the background of the window should be transparent.
If this is true
, writing colors with alpha values different than
1.0
will produce a transparent window.
The default is false
.
sourcepub fn transparent(&self) -> bool
pub fn transparent(&self) -> bool
Get whether the window will support transparency.
sourcepub fn with_decorations(self, decorations: bool) -> Self
pub fn with_decorations(self, decorations: bool) -> Self
Sets whether the window should have a border, a title bar, etc.
The default is true
.
See Window::set_decorations
for details.
sourcepub fn with_always_on_top(self, always_on_top: bool) -> Self
pub fn with_always_on_top(self, always_on_top: bool) -> Self
Sets whether or not the window will always be on top of other windows.
The default is false
.
See Window::set_always_on_top
for details.
sourcepub fn with_window_icon(self, window_icon: Option<Icon>) -> Self
pub fn with_window_icon(self, window_icon: Option<Icon>) -> Self
sourcepub fn build<T: 'static>(
self,
window_target: &EventLoopWindowTarget<T>
) -> Result<Window, OsError>
pub fn build<T: 'static>(
self,
window_target: &EventLoopWindowTarget<T>
) -> Result<Window, OsError>
Builds the window.
Possible causes of error include denied permission, incompatible system, and lack of memory.
Platform-specific
- Web: The window is created but not inserted into the web page automatically. Please see the web platform module for more information.
Trait Implementations
sourceimpl Clone for WindowBuilder
impl Clone for WindowBuilder
sourcefn clone(&self) -> WindowBuilder
fn clone(&self) -> WindowBuilder
1.0.0 · sourceconst fn clone_from(&mut self, source: &Self)
const fn clone_from(&mut self, source: &Self)
source
. Read moresourceimpl Debug for WindowBuilder
impl Debug for WindowBuilder
sourceimpl Default for WindowBuilder
impl Default for WindowBuilder
sourcefn default() -> WindowBuilder
fn default() -> WindowBuilder
sourceimpl WindowBuilderExtUnix for WindowBuilder
impl WindowBuilderExtUnix for WindowBuilder
fn with_x11_visual<T>(self, visual_infos: *const T) -> Self
fn with_x11_screen(self, screen_id: i32) -> Self
sourcefn with_override_redirect(self, override_redirect: bool) -> Self
fn with_override_redirect(self, override_redirect: bool) -> Self
sourcefn with_x11_window_type(self, x11_window_types: Vec<XWindowType>) -> Self
fn with_x11_window_type(self, x11_window_types: Vec<XWindowType>) -> Self
_NET_WM_WINDOW_TYPE
hints; defaults to Normal
. Only relevant on X11.sourcefn with_gtk_theme_variant(self, variant: String) -> Self
fn with_gtk_theme_variant(self, variant: String) -> Self
_GTK_THEME_VARIANT
hint set to the specified value. Currently only relevant on X11.