1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
//! `SK_WINDOW_FOCUS=never`: a host that never takes the foreground.
//!
//! What sk-test sets for every launch, so a spec run on a machine somebody is working at does not
//! pop windows over their work or take the caret: windows open without activation and go to the
//! bottom of the z-order, the startup `cx.activate(true)` is skipped, and `window.focus()` and the
//! devtools `raise` command do nothing.
//!
//! The window still draws every frame behind other windows (`Window::set_draws_while_occluded`;
//! macOS would stop it otherwise), and the devtools screenshot reads gpui's last scene rather than
//! the screen.
//!
//! The window is never active at the OS level, and gpui runs focus only in an active window (an
//! inactive one's focus events carry empty paths, so `on_focus` never fires). So every quiet window
//! is also marked assumed-active (`Window::set_assume_active`, a fork item): focus moves, keyboard
//! events, `document.hasFocus()` and the window's `focused` flag all read as they do in front.
use std::sync::OnceLock;
use gpui::Window;
pub fn never_focus() -> bool {
static ON: OnceLock<bool> = OnceLock::new();
*ON.get_or_init(|| std::env::var("SK_WINDOW_FOCUS").is_ok_and(|v| v == "never"))
}
/// Sends a just-opened window behind every other one, without activating it, and marks it
/// assumed-active (see the module comment). Called from `open_window`'s builder, before the first
/// frame, so it is never seen in front.
pub fn send_to_back(window: &mut Window) {
if !never_focus() {
return;
}
window.set_assume_active(true);
window.set_draws_while_occluded(true);
if let Some(h) = crate::window::capture_hwnd(window) {
send_hwnd_to_back(h);
}
}
/// Reapply the background policy after a deferred native show, outside any
/// App update. The earlier hidden-window ordering is not the final show.
pub(crate) fn send_hwnd_to_back(raw: isize) {
if never_focus() {
to_bottom(raw);
}
}
#[cfg(target_os = "windows")]
fn to_bottom(raw: isize) {
use windows::Win32::Foundation::HWND;
use windows::Win32::UI::WindowsAndMessaging::{
SetWindowPos, HWND_BOTTOM, SWP_NOACTIVATE, SWP_NOMOVE, SWP_NOSIZE,
};
let _ = unsafe {
SetWindowPos(
HWND(raw as *mut _),
Some(HWND_BOTTOM),
0,
0,
0,
0,
SWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE,
)
};
}
#[cfg(not(target_os = "windows"))]
fn to_bottom(_raw: isize) {}