From ecc5bfaeff6503e9e0752035c5e0c94c5a5263a2 Mon Sep 17 00:00:00 2001 From: Héctor Ramón Jiménez Date: Tue, 31 Jan 2023 04:04:29 +0100 Subject: Improve consistency of `window::Action` --- winit/src/window.rs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'winit/src/window.rs') diff --git a/winit/src/window.rs b/winit/src/window.rs index 2306bdf1..0685c87c 100644 --- a/winit/src/window.rs +++ b/winit/src/window.rs @@ -22,12 +22,12 @@ pub fn resize(width: u32, height: u32) -> Command { })) } -/// Sets the window to maximized or back. +/// Maximizes the window. pub fn maximize(value: bool) -> Command { Command::single(command::Action::Window(window::Action::Maximize(value))) } -/// Set the window to minimized or back. +/// Minimes the window. pub fn minimize(value: bool) -> Command { Command::single(command::Action::Window(window::Action::Minimize(value))) } @@ -38,11 +38,11 @@ pub fn move_to(x: i32, y: i32) -> Command { } /// Sets the [`Mode`] of the window. -pub fn set_mode(mode: Mode) -> Command { - Command::single(command::Action::Window(window::Action::SetMode(mode))) +pub fn change_mode(mode: Mode) -> Command { + Command::single(command::Action::Window(window::Action::ChangeMode(mode))) } -/// Sets the window to maximized or back. +/// Toggles the window to maximized or back. pub fn toggle_maximize() -> Command { Command::single(command::Action::Window(window::Action::ToggleMaximize)) } -- cgit From 98a717383acf71d7939d7cc90d350743487f0380 Mon Sep 17 00:00:00 2001 From: Héctor Ramón Jiménez Date: Tue, 31 Jan 2023 04:08:19 +0100 Subject: Write missing `window::Action` helpers in `window` --- winit/src/window.rs | 39 ++++++++++++++++++++++++++++++++++----- 1 file changed, 34 insertions(+), 5 deletions(-) (limited to 'winit/src/window.rs') diff --git a/winit/src/window.rs b/winit/src/window.rs index 0685c87c..6e3a383a 100644 --- a/winit/src/window.rs +++ b/winit/src/window.rs @@ -42,11 +42,6 @@ pub fn change_mode(mode: Mode) -> Command { Command::single(command::Action::Window(window::Action::ChangeMode(mode))) } -/// Toggles the window to maximized or back. -pub fn toggle_maximize() -> Command { - Command::single(command::Action::Window(window::Action::ToggleMaximize)) -} - /// Fetches the current [`Mode`] of the window. pub fn fetch_mode( f: impl FnOnce(Mode) -> Message + 'static, @@ -55,3 +50,37 @@ pub fn fetch_mode( Box::new(f), ))) } + +/// Toggles the window to maximized or back. +pub fn toggle_maximize() -> Command { + Command::single(command::Action::Window(window::Action::ToggleMaximize)) +} + +/// Toggles the window decorations. +pub fn toggle_decorations() -> Command { + Command::single(command::Action::Window(window::Action::ToggleDecorations)) +} + +/// Request user attention to the window, this has no effect if the application +/// is already focused. How requesting for user attention manifests is platform dependent, +/// see [`UserAttention`] for details. +/// +/// Providing `None` will unset the request for user attention. Unsetting the request for +/// user attention might not be done automatically by the WM when the window receives input. +pub fn request_user_attention( + user_attention: Option, +) -> Command { + Command::single(command::Action::Window( + window::Action::RequestUserAttention(user_attention), + )) +} + +/// Brings the window to the front and sets input focus. Has no effect if the window is +/// already in focus, minimized, or not visible. +/// +/// This [`Command`] steals input focus from other applications. Do not use this method unless +/// you are certain that's what the user wants. Focus stealing can cause an extremely disruptive +/// user experience. +pub fn gain_focus() -> Command { + Command::single(command::Action::Window(window::Action::GainFocus)) +} -- cgit