From 81cd0c45b7f18d6f695c16bb1f5ab05b29dc7037 Mon Sep 17 00:00:00 2001 From: Night_Hunter Date: Sat, 10 Dec 2022 01:49:29 +1300 Subject: Add `FocusWindow` to `window::Action` --- native/src/window/action.rs | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'native/src') diff --git a/native/src/window/action.rs b/native/src/window/action.rs index f0fe845d..41d41ee7 100644 --- a/native/src/window/action.rs +++ b/native/src/window/action.rs @@ -58,6 +58,17 @@ pub enum Action { /// - **X11:** Requests for user attention must be manually cleared. /// - **Wayland:** Requires `xdg_activation_v1` protocol, `None` has no effect. RequestUserAttention(Option), + /// 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 method 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. + /// + /// ## Platform-specific + /// + /// - **Web / Wayland:** Unsupported. + FocusWindow, } impl Action { @@ -83,6 +94,7 @@ impl Action { Self::RequestUserAttention(attention_type) => { Action::RequestUserAttention(attention_type) } + Self::FocusWindow => Action::FocusWindow, } } } @@ -109,6 +121,7 @@ impl fmt::Debug for Action { Self::RequestUserAttention(_) => { write!(f, "Action::RequestUserAttention") } + Self::FocusWindow => write!(f, "Action::FocusWindow"), } } } -- cgit