Add WindowBuilder::with_active

CHANGELOG.md

@@ -8,6 +8,7 @@ And please only add new entries to the top of this list, right below the `# Unre
 
 # Unreleased
 
+- On Windows and macOS, add `WindowBuilder::with_active`.
 - Add `Window::is_minimized`.
 - On X11, fix errors handled during `register_xlib_error_hook` invocation bleeding into winit.
 - Add `Window::has_focus`.

src/platform_impl/macos/appkit/window.rs

@@ -114,6 +114,9 @@ extern_methods!(
         #[sel(makeKeyAndOrderFront:)]
         pub fn makeKeyAndOrderFront(&self, sender: Option<&Object>);
 
+        #[sel(orderFront:)]
+        pub fn orderFront(&self, sender: Option<&Object>);
+
         #[sel(miniaturize:)]
         pub fn miniaturize(&self, sender: Option<&Object>);
 

src/platform_impl/macos/window.rs

@@ -19,6 +19,7 @@ use crate::{
         LogicalPosition, LogicalSize, PhysicalPosition, PhysicalSize, Position, Size, Size::Logical,
     },
     error::{ExternalError, NotSupportedError, OsError as RootOsError},
+    event::WindowEvent,
     icon::Icon,
     platform::macos::WindowExtMacOS,
     platform_impl::platform::{
@@ -464,14 +465,20 @@ impl WinitWindow {
         // state, since otherwise we'll briefly see the window at normal size
         // before it transitions.
         if attrs.visible {
-            // Tightly linked with `app_state::window_activation_hack`
-            this.makeKeyAndOrderFront(None);
+            if attrs.active {
+                // Tightly linked with `app_state::window_activation_hack`
+                this.makeKeyAndOrderFront(None);
+            } else {
+                this.orderFront(None);
+            }
         }
 
         if attrs.maximized {
             this.set_maximized(attrs.maximized);
         }
 
+        delegate.emit_event(WindowEvent::Focused(false));
+
         Ok((this, delegate))
     }
 

src/platform_impl/macos/window_delegate.rs

@@ -406,7 +406,7 @@ impl WinitWindowDelegate {
         }
     }
 
-    fn emit_event(&self, event: WindowEvent<'static>) {
+    pub(crate) fn emit_event(&self, event: WindowEvent<'static>) {
         let event = Event::WindowEvent {
             window_id: WindowId(self.window.id()),
             event,

src/platform_impl/windows/window.rs

@@ -1077,6 +1077,7 @@ where
         WindowFlags::NO_BACK_BUFFER,
         pl_attribs.no_redirection_bitmap,
     );
+    window_flags.set(WindowFlags::MARKER_NO_ACTIVATE, !attributes.active);
     window_flags.set(WindowFlags::TRANSPARENT, attributes.transparent);
     // WindowFlags::VISIBLE and MAXIMIZED are set down below after the window has been configured.
     window_flags.set(WindowFlags::RESIZABLE, attributes.resizable);

src/platform_impl/windows/window_state.rs

@@ -116,6 +116,8 @@ bitflags! {
         /// Drop shadow for undecorated windows.
         const MARKER_UNDECORATED_SHADOW = 1 << 20;
 
+        const MARKER_NO_ACTIVATE = 1 << 18;
+
         const EXCLUSIVE_FULLSCREEN_OR_MASK = WindowFlags::ALWAYS_ON_TOP.bits;
     }
 }
@@ -306,8 +308,14 @@ impl WindowFlags {
         }
 
         if new.contains(WindowFlags::VISIBLE) {
+            let flag = if self.contains(WindowFlags::MARKER_NO_ACTIVATE) {
+                self.set(WindowFlags::MARKER_NO_ACTIVATE, false);
+                SWP_NOACTIVATE
+            } else {
+                SW_SHOW
+            };
             unsafe {
-                ShowWindow(window, SW_SHOW);
+                ShowWindow(window, flag);
             }
         }
 

src/window.rs

@@ -139,6 +139,7 @@ pub(crate) struct WindowAttributes {
     pub content_protected: bool,
     pub window_level: WindowLevel,
     pub parent_window: Option<RawWindowHandle>,
+    pub active: bool,
 }
 
 impl Default for WindowAttributes {
@@ -163,6 +164,7 @@ impl Default for WindowAttributes {
             resize_increments: None,
             content_protected: false,
             parent_window: None,
+            active: true,
         }
     }
 }
@@ -405,6 +407,17 @@ impl WindowBuilder {
         self
     }
 
+    /// Whether the window will be initially focused or not.
+    ///
+    /// ## Platform-specific:
+    ///
+    /// **Android / iOS / X11 / Wayland / Orbital:** Unsupported.
+    #[inline]
+    pub fn with_active(mut self, active: bool) -> WindowBuilder {
+        self.window.active = active;
+        self
+    }
+
     /// Build window with parent window.
     ///
     /// The default is `None`.