summaryrefslogtreecommitdiffstats
path: root/native/src
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--native/src/window/action.rs13
1 files changed, 13 insertions, 0 deletions
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<T> {
/// - **X11:** Requests for user attention must be manually cleared.
/// - **Wayland:** Requires `xdg_activation_v1` protocol, `None` has no effect.
RequestUserAttention(Option<UserAttention>),
+ /// 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<T> Action<T> {
@@ -83,6 +94,7 @@ impl<T> Action<T> {
Self::RequestUserAttention(attention_type) => {
Action::RequestUserAttention(attention_type)
}
+ Self::FocusWindow => Action::FocusWindow,
}
}
}
@@ -109,6 +121,7 @@ impl<T> fmt::Debug for Action<T> {
Self::RequestUserAttention(_) => {
write!(f, "Action::RequestUserAttention")
}
+ Self::FocusWindow => write!(f, "Action::FocusWindow"),
}
}
}