events.rs

   1use std::rc::Rc;
   2
   3use ::util::ResultExt;
   4use anyhow::Context as _;
   5use windows::{
   6    Win32::{
   7        Foundation::*,
   8        Graphics::Gdi::*,
   9        System::SystemServices::*,
  10        UI::{
  11            Controls::*,
  12            HiDpi::*,
  13            Input::{Ime::*, KeyboardAndMouse::*},
  14            WindowsAndMessaging::*,
  15        },
  16    },
  17    core::PCWSTR,
  18};
  19
  20use crate::*;
  21
  22pub(crate) const WM_GPUI_CURSOR_STYLE_CHANGED: u32 = WM_USER + 1;
  23pub(crate) const WM_GPUI_CLOSE_ONE_WINDOW: u32 = WM_USER + 2;
  24pub(crate) const WM_GPUI_TASK_DISPATCHED_ON_MAIN_THREAD: u32 = WM_USER + 3;
  25pub(crate) const WM_GPUI_DOCK_MENU_ACTION: u32 = WM_USER + 4;
  26pub(crate) const WM_GPUI_FORCE_UPDATE_WINDOW: u32 = WM_USER + 5;
  27pub(crate) const WM_GPUI_KEYBOARD_LAYOUT_CHANGED: u32 = WM_USER + 6;
  28pub(crate) const WM_GPUI_GPU_DEVICE_LOST: u32 = WM_USER + 7;
  29pub(crate) const WM_GPUI_KEYDOWN: u32 = WM_USER + 8;
  30
  31const SIZE_MOVE_LOOP_TIMER_ID: usize = 1;
  32const AUTO_HIDE_TASKBAR_THICKNESS_PX: i32 = 1;
  33
  34impl WindowsWindowInner {
  35    pub(crate) fn handle_msg(
  36        self: &Rc<Self>,
  37        handle: HWND,
  38        msg: u32,
  39        wparam: WPARAM,
  40        lparam: LPARAM,
  41    ) -> LRESULT {
  42        let handled = match msg {
  43            // eagerly activate the window, so calls to `active_window` will work correctly
  44            WM_MOUSEACTIVATE => {
  45                unsafe { SetActiveWindow(handle).ok() };
  46                None
  47            }
  48            WM_ACTIVATE => self.handle_activate_msg(wparam),
  49            WM_CREATE => self.handle_create_msg(handle),
  50            WM_MOVE => self.handle_move_msg(handle, lparam),
  51            WM_SIZE => self.handle_size_msg(wparam, lparam),
  52            WM_GETMINMAXINFO => self.handle_get_min_max_info_msg(lparam),
  53            WM_ENTERSIZEMOVE | WM_ENTERMENULOOP => self.handle_size_move_loop(handle),
  54            WM_EXITSIZEMOVE | WM_EXITMENULOOP => self.handle_size_move_loop_exit(handle),
  55            WM_TIMER => self.handle_timer_msg(handle, wparam),
  56            WM_NCCALCSIZE => self.handle_calc_client_size(handle, wparam, lparam),
  57            WM_DPICHANGED => self.handle_dpi_changed_msg(handle, wparam, lparam),
  58            WM_DISPLAYCHANGE => self.handle_display_change_msg(handle),
  59            WM_NCHITTEST => self.handle_hit_test_msg(handle, lparam),
  60            WM_PAINT => self.handle_paint_msg(handle),
  61            WM_CLOSE => self.handle_close_msg(),
  62            WM_DESTROY => self.handle_destroy_msg(handle),
  63            WM_MOUSEMOVE => self.handle_mouse_move_msg(handle, lparam, wparam),
  64            WM_MOUSELEAVE | WM_NCMOUSELEAVE => self.handle_mouse_leave_msg(),
  65            WM_NCMOUSEMOVE => self.handle_nc_mouse_move_msg(handle, lparam),
  66            // Treat double click as a second single click, since we track the double clicks ourselves.
  67            // If you don't interact with any elements, this will fall through to the windows default
  68            // behavior of toggling whether the window is maximized.
  69            WM_NCLBUTTONDBLCLK | WM_NCLBUTTONDOWN => {
  70                self.handle_nc_mouse_down_msg(handle, MouseButton::Left, wparam, lparam)
  71            }
  72            WM_NCRBUTTONDOWN => {
  73                self.handle_nc_mouse_down_msg(handle, MouseButton::Right, wparam, lparam)
  74            }
  75            WM_NCMBUTTONDOWN => {
  76                self.handle_nc_mouse_down_msg(handle, MouseButton::Middle, wparam, lparam)
  77            }
  78            WM_NCLBUTTONUP => {
  79                self.handle_nc_mouse_up_msg(handle, MouseButton::Left, wparam, lparam)
  80            }
  81            WM_NCRBUTTONUP => {
  82                self.handle_nc_mouse_up_msg(handle, MouseButton::Right, wparam, lparam)
  83            }
  84            WM_NCMBUTTONUP => {
  85                self.handle_nc_mouse_up_msg(handle, MouseButton::Middle, wparam, lparam)
  86            }
  87            WM_LBUTTONDOWN => self.handle_mouse_down_msg(handle, MouseButton::Left, lparam),
  88            WM_RBUTTONDOWN => self.handle_mouse_down_msg(handle, MouseButton::Right, lparam),
  89            WM_MBUTTONDOWN => self.handle_mouse_down_msg(handle, MouseButton::Middle, lparam),
  90            WM_XBUTTONDOWN => {
  91                self.handle_xbutton_msg(handle, wparam, lparam, Self::handle_mouse_down_msg)
  92            }
  93            WM_LBUTTONUP => self.handle_mouse_up_msg(handle, MouseButton::Left, lparam),
  94            WM_RBUTTONUP => self.handle_mouse_up_msg(handle, MouseButton::Right, lparam),
  95            WM_MBUTTONUP => self.handle_mouse_up_msg(handle, MouseButton::Middle, lparam),
  96            WM_XBUTTONUP => {
  97                self.handle_xbutton_msg(handle, wparam, lparam, Self::handle_mouse_up_msg)
  98            }
  99            WM_MOUSEWHEEL => self.handle_mouse_wheel_msg(handle, wparam, lparam),
 100            WM_MOUSEHWHEEL => self.handle_mouse_horizontal_wheel_msg(handle, wparam, lparam),
 101            WM_SYSKEYUP => self.handle_syskeyup_msg(wparam, lparam),
 102            WM_KEYUP => self.handle_keyup_msg(wparam, lparam),
 103            WM_GPUI_KEYDOWN => self.handle_keydown_msg(wparam, lparam),
 104            WM_CHAR => self.handle_char_msg(wparam),
 105            WM_IME_STARTCOMPOSITION => self.handle_ime_position(handle),
 106            WM_IME_COMPOSITION => self.handle_ime_composition(handle, lparam),
 107            WM_SETCURSOR => self.handle_set_cursor(handle, lparam),
 108            WM_SETTINGCHANGE => self.handle_system_settings_changed(handle, wparam, lparam),
 109            WM_INPUTLANGCHANGE => self.handle_input_language_changed(),
 110            WM_SHOWWINDOW => self.handle_window_visibility_changed(handle, wparam),
 111            WM_GPUI_CURSOR_STYLE_CHANGED => self.handle_cursor_changed(lparam),
 112            WM_GPUI_FORCE_UPDATE_WINDOW => self.draw_window(handle, true),
 113            WM_GPUI_GPU_DEVICE_LOST => self.handle_device_lost(lparam),
 114            _ => None,
 115        };
 116        if let Some(n) = handled {
 117            LRESULT(n)
 118        } else {
 119            unsafe { DefWindowProcW(handle, msg, wparam, lparam) }
 120        }
 121    }
 122
 123    fn handle_move_msg(&self, handle: HWND, lparam: LPARAM) -> Option<isize> {
 124        let origin = logical_point(
 125            lparam.signed_loword() as f32,
 126            lparam.signed_hiword() as f32,
 127            self.state.scale_factor.get(),
 128        );
 129        self.state.origin.set(origin);
 130        let size = self.state.logical_size.get();
 131        let center_x = origin.x.0 + size.width.0 / 2.;
 132        let center_y = origin.y.0 + size.height.0 / 2.;
 133        let monitor_bounds = self.state.display.get().bounds();
 134        if center_x < monitor_bounds.left().0
 135            || center_x > monitor_bounds.right().0
 136            || center_y < monitor_bounds.top().0
 137            || center_y > monitor_bounds.bottom().0
 138        {
 139            // center of the window may have moved to another monitor
 140            let monitor = unsafe { MonitorFromWindow(handle, MONITOR_DEFAULTTONULL) };
 141            // minimize the window can trigger this event too, in this case,
 142            // monitor is invalid, we do nothing.
 143            if !monitor.is_invalid() && self.state.display.get().handle != monitor {
 144                // we will get the same monitor if we only have one
 145                self.state
 146                    .display
 147                    .set(WindowsDisplay::new_with_handle(monitor).log_err()?);
 148            }
 149        }
 150        if let Some(mut callback) = self.state.callbacks.moved.take() {
 151            callback();
 152            self.state.callbacks.moved.set(Some(callback));
 153        }
 154        Some(0)
 155    }
 156
 157    fn handle_get_min_max_info_msg(&self, lparam: LPARAM) -> Option<isize> {
 158        let min_size = self.state.min_size?;
 159        let scale_factor = self.state.scale_factor.get();
 160        let boarder_offset = &self.state.border_offset;
 161
 162        unsafe {
 163            let minmax_info = &mut *(lparam.0 as *mut MINMAXINFO);
 164            minmax_info.ptMinTrackSize.x =
 165                min_size.width.scale(scale_factor).0 as i32 + boarder_offset.width_offset.get();
 166            minmax_info.ptMinTrackSize.y =
 167                min_size.height.scale(scale_factor).0 as i32 + boarder_offset.height_offset.get();
 168        }
 169        Some(0)
 170    }
 171
 172    fn handle_size_msg(&self, wparam: WPARAM, lparam: LPARAM) -> Option<isize> {
 173        // Don't resize the renderer when the window is minimized, but record that it was minimized so
 174        // that on restore the swap chain can be recreated via `update_drawable_size_even_if_unchanged`.
 175        if wparam.0 == SIZE_MINIMIZED as usize {
 176            self.state
 177                .restore_from_minimized
 178                .set(self.state.callbacks.request_frame.take());
 179            return Some(0);
 180        }
 181
 182        let width = lparam.loword().max(1) as i32;
 183        let height = lparam.hiword().max(1) as i32;
 184        let new_size = size(DevicePixels(width), DevicePixels(height));
 185
 186        let scale_factor = self.state.scale_factor.get();
 187        let mut should_resize_renderer = false;
 188        if let Some(restore_from_minimized) = self.state.restore_from_minimized.take() {
 189            self.state
 190                .callbacks
 191                .request_frame
 192                .set(Some(restore_from_minimized));
 193        } else {
 194            should_resize_renderer = true;
 195        }
 196
 197        self.handle_size_change(new_size, scale_factor, should_resize_renderer);
 198        Some(0)
 199    }
 200
 201    fn handle_size_change(
 202        &self,
 203        device_size: Size<DevicePixels>,
 204        scale_factor: f32,
 205        should_resize_renderer: bool,
 206    ) {
 207        let new_logical_size = device_size.to_pixels(scale_factor);
 208
 209        self.state.logical_size.set(new_logical_size);
 210        if should_resize_renderer
 211            && let Err(e) = self.state.renderer.borrow_mut().resize(device_size)
 212        {
 213            log::error!("Failed to resize renderer, invalidating devices: {}", e);
 214            self.state
 215                .invalidate_devices
 216                .store(true, std::sync::atomic::Ordering::Release);
 217        }
 218        if let Some(mut callback) = self.state.callbacks.resize.take() {
 219            callback(new_logical_size, scale_factor);
 220            self.state.callbacks.resize.set(Some(callback));
 221        }
 222    }
 223
 224    fn handle_size_move_loop(&self, handle: HWND) -> Option<isize> {
 225        unsafe {
 226            let ret = SetTimer(
 227                Some(handle),
 228                SIZE_MOVE_LOOP_TIMER_ID,
 229                USER_TIMER_MINIMUM,
 230                None,
 231            );
 232            if ret == 0 {
 233                log::error!(
 234                    "unable to create timer: {}",
 235                    std::io::Error::last_os_error()
 236                );
 237            }
 238        }
 239        None
 240    }
 241
 242    fn handle_size_move_loop_exit(&self, handle: HWND) -> Option<isize> {
 243        unsafe {
 244            KillTimer(Some(handle), SIZE_MOVE_LOOP_TIMER_ID).log_err();
 245        }
 246        None
 247    }
 248
 249    fn handle_timer_msg(&self, handle: HWND, wparam: WPARAM) -> Option<isize> {
 250        if wparam.0 == SIZE_MOVE_LOOP_TIMER_ID {
 251            let mut runnables = self.main_receiver.clone().try_iter();
 252            while let Some(Ok(runnable)) = runnables.next() {
 253                WindowsDispatcher::execute_runnable(runnable);
 254            }
 255            self.handle_paint_msg(handle)
 256        } else {
 257            None
 258        }
 259    }
 260
 261    fn handle_paint_msg(&self, handle: HWND) -> Option<isize> {
 262        self.draw_window(handle, false)
 263    }
 264
 265    fn handle_close_msg(&self) -> Option<isize> {
 266        let mut callback = self.state.callbacks.should_close.take()?;
 267        let should_close = callback();
 268        self.state.callbacks.should_close.set(Some(callback));
 269        if should_close { None } else { Some(0) }
 270    }
 271
 272    fn handle_destroy_msg(&self, handle: HWND) -> Option<isize> {
 273        let callback = { self.state.callbacks.close.take() };
 274        // Re-enable parent window if this was a modal dialog
 275        if let Some(parent_hwnd) = self.parent_hwnd {
 276            unsafe {
 277                let _ = EnableWindow(parent_hwnd, true);
 278                let _ = SetForegroundWindow(parent_hwnd);
 279            }
 280        }
 281
 282        if let Some(callback) = callback {
 283            callback();
 284        }
 285        unsafe {
 286            PostMessageW(
 287                Some(self.platform_window_handle),
 288                WM_GPUI_CLOSE_ONE_WINDOW,
 289                WPARAM(self.validation_number),
 290                LPARAM(handle.0 as isize),
 291            )
 292            .log_err();
 293        }
 294        Some(0)
 295    }
 296
 297    fn handle_mouse_move_msg(&self, handle: HWND, lparam: LPARAM, wparam: WPARAM) -> Option<isize> {
 298        self.start_tracking_mouse(handle, TME_LEAVE);
 299
 300        let Some(mut func) = self.state.callbacks.input.take() else {
 301            return Some(1);
 302        };
 303        let scale_factor = self.state.scale_factor.get();
 304
 305        let pressed_button = match MODIFIERKEYS_FLAGS(wparam.loword() as u32) {
 306            flags if flags.contains(MK_LBUTTON) => Some(MouseButton::Left),
 307            flags if flags.contains(MK_RBUTTON) => Some(MouseButton::Right),
 308            flags if flags.contains(MK_MBUTTON) => Some(MouseButton::Middle),
 309            flags if flags.contains(MK_XBUTTON1) => {
 310                Some(MouseButton::Navigate(NavigationDirection::Back))
 311            }
 312            flags if flags.contains(MK_XBUTTON2) => {
 313                Some(MouseButton::Navigate(NavigationDirection::Forward))
 314            }
 315            _ => None,
 316        };
 317        let x = lparam.signed_loword() as f32;
 318        let y = lparam.signed_hiword() as f32;
 319        let input = PlatformInput::MouseMove(MouseMoveEvent {
 320            position: logical_point(x, y, scale_factor),
 321            pressed_button,
 322            modifiers: current_modifiers(),
 323        });
 324        let handled = !func(input).propagate;
 325        self.state.callbacks.input.set(Some(func));
 326
 327        if handled { Some(0) } else { Some(1) }
 328    }
 329
 330    fn handle_mouse_leave_msg(&self) -> Option<isize> {
 331        self.state.hovered.set(false);
 332        if let Some(mut callback) = self.state.callbacks.hovered_status_change.take() {
 333            callback(false);
 334            self.state
 335                .callbacks
 336                .hovered_status_change
 337                .set(Some(callback));
 338        }
 339
 340        Some(0)
 341    }
 342
 343    fn handle_syskeyup_msg(&self, wparam: WPARAM, lparam: LPARAM) -> Option<isize> {
 344        let input = handle_key_event(wparam, lparam, &self.state, |keystroke, _| {
 345            PlatformInput::KeyUp(KeyUpEvent { keystroke })
 346        })?;
 347        let mut func = self.state.callbacks.input.take()?;
 348
 349        func(input);
 350        self.state.callbacks.input.set(Some(func));
 351
 352        // Always return 0 to indicate that the message was handled, so we could properly handle `ModifiersChanged` event.
 353        Some(0)
 354    }
 355
 356    // It's a known bug that you can't trigger `ctrl-shift-0`. See:
 357    // https://superuser.com/questions/1455762/ctrl-shift-number-key-combination-has-stopped-working-for-a-few-numbers
 358    fn handle_keydown_msg(&self, wparam: WPARAM, lparam: LPARAM) -> Option<isize> {
 359        let Some(input) = handle_key_event(
 360            wparam,
 361            lparam,
 362            &self.state,
 363            |keystroke, prefer_character_input| {
 364                PlatformInput::KeyDown(KeyDownEvent {
 365                    keystroke,
 366                    is_held: lparam.0 & (0x1 << 30) > 0,
 367                    prefer_character_input,
 368                })
 369            },
 370        ) else {
 371            return Some(1);
 372        };
 373
 374        let Some(mut func) = self.state.callbacks.input.take() else {
 375            return Some(1);
 376        };
 377
 378        let handled = !func(input).propagate;
 379
 380        self.state.callbacks.input.set(Some(func));
 381
 382        if handled { Some(0) } else { Some(1) }
 383    }
 384
 385    fn handle_keyup_msg(&self, wparam: WPARAM, lparam: LPARAM) -> Option<isize> {
 386        let Some(input) = handle_key_event(wparam, lparam, &self.state, |keystroke, _| {
 387            PlatformInput::KeyUp(KeyUpEvent { keystroke })
 388        }) else {
 389            return Some(1);
 390        };
 391
 392        let Some(mut func) = self.state.callbacks.input.take() else {
 393            return Some(1);
 394        };
 395
 396        let handled = !func(input).propagate;
 397        self.state.callbacks.input.set(Some(func));
 398
 399        if handled { Some(0) } else { Some(1) }
 400    }
 401
 402    fn handle_char_msg(&self, wparam: WPARAM) -> Option<isize> {
 403        let input = self.parse_char_message(wparam)?;
 404        self.with_input_handler(|input_handler| {
 405            input_handler.replace_text_in_range(None, &input);
 406        });
 407
 408        Some(0)
 409    }
 410
 411    fn handle_mouse_down_msg(
 412        &self,
 413        handle: HWND,
 414        button: MouseButton,
 415        lparam: LPARAM,
 416    ) -> Option<isize> {
 417        unsafe { SetCapture(handle) };
 418
 419        let Some(mut func) = self.state.callbacks.input.take() else {
 420            return Some(1);
 421        };
 422        let x = lparam.signed_loword();
 423        let y = lparam.signed_hiword();
 424        let physical_point = point(DevicePixels(x as i32), DevicePixels(y as i32));
 425        let click_count = self.state.click_state.update(button, physical_point);
 426        let scale_factor = self.state.scale_factor.get();
 427
 428        let input = PlatformInput::MouseDown(MouseDownEvent {
 429            button,
 430            position: logical_point(x as f32, y as f32, scale_factor),
 431            modifiers: current_modifiers(),
 432            click_count,
 433            first_mouse: false,
 434        });
 435        let handled = !func(input).propagate;
 436        self.state.callbacks.input.set(Some(func));
 437
 438        if handled { Some(0) } else { Some(1) }
 439    }
 440
 441    fn handle_mouse_up_msg(
 442        &self,
 443        _handle: HWND,
 444        button: MouseButton,
 445        lparam: LPARAM,
 446    ) -> Option<isize> {
 447        unsafe { ReleaseCapture().log_err() };
 448
 449        let Some(mut func) = self.state.callbacks.input.take() else {
 450            return Some(1);
 451        };
 452        let x = lparam.signed_loword() as f32;
 453        let y = lparam.signed_hiword() as f32;
 454        let click_count = self.state.click_state.current_count.get();
 455        let scale_factor = self.state.scale_factor.get();
 456
 457        let input = PlatformInput::MouseUp(MouseUpEvent {
 458            button,
 459            position: logical_point(x, y, scale_factor),
 460            modifiers: current_modifiers(),
 461            click_count,
 462        });
 463        let handled = !func(input).propagate;
 464        self.state.callbacks.input.set(Some(func));
 465
 466        if handled { Some(0) } else { Some(1) }
 467    }
 468
 469    fn handle_xbutton_msg(
 470        &self,
 471        handle: HWND,
 472        wparam: WPARAM,
 473        lparam: LPARAM,
 474        handler: impl Fn(&Self, HWND, MouseButton, LPARAM) -> Option<isize>,
 475    ) -> Option<isize> {
 476        let nav_dir = match wparam.hiword() {
 477            XBUTTON1 => NavigationDirection::Back,
 478            XBUTTON2 => NavigationDirection::Forward,
 479            _ => return Some(1),
 480        };
 481        handler(self, handle, MouseButton::Navigate(nav_dir), lparam)
 482    }
 483
 484    fn handle_mouse_wheel_msg(
 485        &self,
 486        handle: HWND,
 487        wparam: WPARAM,
 488        lparam: LPARAM,
 489    ) -> Option<isize> {
 490        let modifiers = current_modifiers();
 491
 492        let Some(mut func) = self.state.callbacks.input.take() else {
 493            return Some(1);
 494        };
 495        let scale_factor = self.state.scale_factor.get();
 496        let wheel_scroll_amount = match modifiers.shift {
 497            true => self
 498                .system_settings()
 499                .mouse_wheel_settings
 500                .wheel_scroll_chars
 501                .get(),
 502            false => self
 503                .system_settings()
 504                .mouse_wheel_settings
 505                .wheel_scroll_lines
 506                .get(),
 507        };
 508
 509        let wheel_distance =
 510            (wparam.signed_hiword() as f32 / WHEEL_DELTA as f32) * wheel_scroll_amount as f32;
 511        let mut cursor_point = POINT {
 512            x: lparam.signed_loword().into(),
 513            y: lparam.signed_hiword().into(),
 514        };
 515        unsafe { ScreenToClient(handle, &mut cursor_point).ok().log_err() };
 516        let input = PlatformInput::ScrollWheel(ScrollWheelEvent {
 517            position: logical_point(cursor_point.x as f32, cursor_point.y as f32, scale_factor),
 518            delta: ScrollDelta::Lines(match modifiers.shift {
 519                true => Point {
 520                    x: wheel_distance,
 521                    y: 0.0,
 522                },
 523                false => Point {
 524                    y: wheel_distance,
 525                    x: 0.0,
 526                },
 527            }),
 528            modifiers,
 529            touch_phase: TouchPhase::Moved,
 530        });
 531        let handled = !func(input).propagate;
 532        self.state.callbacks.input.set(Some(func));
 533
 534        if handled { Some(0) } else { Some(1) }
 535    }
 536
 537    fn handle_mouse_horizontal_wheel_msg(
 538        &self,
 539        handle: HWND,
 540        wparam: WPARAM,
 541        lparam: LPARAM,
 542    ) -> Option<isize> {
 543        let Some(mut func) = self.state.callbacks.input.take() else {
 544            return Some(1);
 545        };
 546        let scale_factor = self.state.scale_factor.get();
 547        let wheel_scroll_chars = self
 548            .system_settings()
 549            .mouse_wheel_settings
 550            .wheel_scroll_chars
 551            .get();
 552
 553        let wheel_distance =
 554            (-wparam.signed_hiword() as f32 / WHEEL_DELTA as f32) * wheel_scroll_chars as f32;
 555        let mut cursor_point = POINT {
 556            x: lparam.signed_loword().into(),
 557            y: lparam.signed_hiword().into(),
 558        };
 559        unsafe { ScreenToClient(handle, &mut cursor_point).ok().log_err() };
 560        let event = PlatformInput::ScrollWheel(ScrollWheelEvent {
 561            position: logical_point(cursor_point.x as f32, cursor_point.y as f32, scale_factor),
 562            delta: ScrollDelta::Lines(Point {
 563                x: wheel_distance,
 564                y: 0.0,
 565            }),
 566            modifiers: current_modifiers(),
 567            touch_phase: TouchPhase::Moved,
 568        });
 569        let handled = !func(event).propagate;
 570        self.state.callbacks.input.set(Some(func));
 571
 572        if handled { Some(0) } else { Some(1) }
 573    }
 574
 575    fn retrieve_caret_position(&self) -> Option<POINT> {
 576        self.with_input_handler_and_scale_factor(|input_handler, scale_factor| {
 577            let caret_range = input_handler.selected_text_range(false)?;
 578            let caret_position = input_handler.bounds_for_range(caret_range.range)?;
 579            Some(POINT {
 580                // logical to physical
 581                x: (caret_position.origin.x.0 * scale_factor) as i32,
 582                y: (caret_position.origin.y.0 * scale_factor) as i32
 583                    + ((caret_position.size.height.0 * scale_factor) as i32 / 2),
 584            })
 585        })
 586    }
 587
 588    fn handle_ime_position(&self, handle: HWND) -> Option<isize> {
 589        if let Some(caret_position) = self.retrieve_caret_position() {
 590            self.update_ime_position(handle, caret_position);
 591        }
 592        Some(0)
 593    }
 594
 595    pub(crate) fn update_ime_position(&self, handle: HWND, caret_position: POINT) {
 596        unsafe {
 597            let ctx = ImmGetContext(handle);
 598            if ctx.is_invalid() {
 599                return;
 600            }
 601
 602            let config = COMPOSITIONFORM {
 603                dwStyle: CFS_POINT,
 604                ptCurrentPos: caret_position,
 605                ..Default::default()
 606            };
 607            ImmSetCompositionWindow(ctx, &config).ok().log_err();
 608            let config = CANDIDATEFORM {
 609                dwStyle: CFS_CANDIDATEPOS,
 610                ptCurrentPos: caret_position,
 611                ..Default::default()
 612            };
 613            ImmSetCandidateWindow(ctx, &config).ok().log_err();
 614            ImmReleaseContext(handle, ctx).ok().log_err();
 615        }
 616    }
 617
 618    fn handle_ime_composition(&self, handle: HWND, lparam: LPARAM) -> Option<isize> {
 619        let ctx = unsafe { ImmGetContext(handle) };
 620        let result = self.handle_ime_composition_inner(ctx, lparam);
 621        unsafe { ImmReleaseContext(handle, ctx).ok().log_err() };
 622        result
 623    }
 624
 625    fn handle_ime_composition_inner(&self, ctx: HIMC, lparam: LPARAM) -> Option<isize> {
 626        let lparam = lparam.0 as u32;
 627        if lparam == 0 {
 628            // Japanese IME may send this message with lparam = 0, which indicates that
 629            // there is no composition string.
 630            self.with_input_handler(|input_handler| {
 631                input_handler.replace_text_in_range(None, "");
 632            })?;
 633            Some(0)
 634        } else {
 635            if lparam & GCS_RESULTSTR.0 > 0 {
 636                let comp_result = parse_ime_composition_string(ctx, GCS_RESULTSTR)?;
 637                self.with_input_handler(|input_handler| {
 638                    input_handler
 639                        .replace_text_in_range(None, &String::from_utf16_lossy(&comp_result));
 640                })?;
 641            }
 642            if lparam & GCS_COMPSTR.0 > 0 {
 643                let comp_string = parse_ime_composition_string(ctx, GCS_COMPSTR)?;
 644                let caret_pos =
 645                    (!comp_string.is_empty() && lparam & GCS_CURSORPOS.0 > 0).then(|| {
 646                        let cursor_pos = retrieve_composition_cursor_position(ctx);
 647                        let pos = if should_use_ime_cursor_position(ctx, cursor_pos) {
 648                            cursor_pos
 649                        } else {
 650                            comp_string.len()
 651                        };
 652                        pos..pos
 653                    });
 654                self.with_input_handler(|input_handler| {
 655                    input_handler.replace_and_mark_text_in_range(
 656                        None,
 657                        &String::from_utf16_lossy(&comp_string),
 658                        caret_pos,
 659                    );
 660                })?;
 661            }
 662            if lparam & (GCS_RESULTSTR.0 | GCS_COMPSTR.0) > 0 {
 663                return Some(0);
 664            }
 665
 666            // currently, we don't care other stuff
 667            None
 668        }
 669    }
 670
 671    /// SEE: https://learn.microsoft.com/en-us/windows/win32/winmsg/wm-nccalcsize
 672    fn handle_calc_client_size(
 673        &self,
 674        handle: HWND,
 675        wparam: WPARAM,
 676        lparam: LPARAM,
 677    ) -> Option<isize> {
 678        if !self.hide_title_bar || self.state.is_fullscreen() || wparam.0 == 0 {
 679            return None;
 680        }
 681
 682        let is_maximized = self.state.is_maximized();
 683        let insets = get_client_area_insets(handle, is_maximized, self.windows_version);
 684        // wparam is TRUE so lparam points to an NCCALCSIZE_PARAMS structure
 685        let mut params = lparam.0 as *mut NCCALCSIZE_PARAMS;
 686        let mut requested_client_rect = unsafe { &mut ((*params).rgrc) };
 687
 688        requested_client_rect[0].left += insets.left;
 689        requested_client_rect[0].top += insets.top;
 690        requested_client_rect[0].right -= insets.right;
 691        requested_client_rect[0].bottom -= insets.bottom;
 692
 693        // Fix auto hide taskbar not showing. This solution is based on the approach
 694        // used by Chrome. However, it may result in one row of pixels being obscured
 695        // in our client area. But as Chrome says, "there seems to be no better solution."
 696        if is_maximized
 697            && let Some(taskbar_position) = self.system_settings().auto_hide_taskbar_position.get()
 698        {
 699            // For the auto-hide taskbar, adjust in by 1 pixel on taskbar edge,
 700            // so the window isn't treated as a "fullscreen app", which would cause
 701            // the taskbar to disappear.
 702            match taskbar_position {
 703                AutoHideTaskbarPosition::Left => {
 704                    requested_client_rect[0].left += AUTO_HIDE_TASKBAR_THICKNESS_PX
 705                }
 706                AutoHideTaskbarPosition::Top => {
 707                    requested_client_rect[0].top += AUTO_HIDE_TASKBAR_THICKNESS_PX
 708                }
 709                AutoHideTaskbarPosition::Right => {
 710                    requested_client_rect[0].right -= AUTO_HIDE_TASKBAR_THICKNESS_PX
 711                }
 712                AutoHideTaskbarPosition::Bottom => {
 713                    requested_client_rect[0].bottom -= AUTO_HIDE_TASKBAR_THICKNESS_PX
 714                }
 715            }
 716        }
 717
 718        Some(0)
 719    }
 720
 721    fn handle_activate_msg(self: &Rc<Self>, wparam: WPARAM) -> Option<isize> {
 722        let activated = wparam.loword() > 0;
 723        let this = self.clone();
 724        self.executor
 725            .spawn(async move {
 726                if let Some(mut func) = this.state.callbacks.active_status_change.take() {
 727                    func(activated);
 728                    this.state.callbacks.active_status_change.set(Some(func));
 729                }
 730            })
 731            .detach();
 732
 733        None
 734    }
 735
 736    fn handle_create_msg(&self, handle: HWND) -> Option<isize> {
 737        if self.hide_title_bar {
 738            notify_frame_changed(handle);
 739            Some(0)
 740        } else {
 741            None
 742        }
 743    }
 744
 745    fn handle_dpi_changed_msg(
 746        &self,
 747        handle: HWND,
 748        wparam: WPARAM,
 749        lparam: LPARAM,
 750    ) -> Option<isize> {
 751        let new_dpi = wparam.loword() as f32;
 752
 753        let is_maximized = self.state.is_maximized();
 754        let new_scale_factor = new_dpi / USER_DEFAULT_SCREEN_DPI as f32;
 755        self.state.scale_factor.set(new_scale_factor);
 756        self.state.border_offset.update(handle).log_err();
 757
 758        if is_maximized {
 759            // Get the monitor and its work area at the new DPI
 760            let monitor = unsafe { MonitorFromWindow(handle, MONITOR_DEFAULTTONEAREST) };
 761            let mut monitor_info: MONITORINFO = unsafe { std::mem::zeroed() };
 762            monitor_info.cbSize = std::mem::size_of::<MONITORINFO>() as u32;
 763            if unsafe { GetMonitorInfoW(monitor, &mut monitor_info) }.as_bool() {
 764                let work_area = monitor_info.rcWork;
 765                let width = work_area.right - work_area.left;
 766                let height = work_area.bottom - work_area.top;
 767
 768                // Update the window size to match the new monitor work area
 769                // This will trigger WM_SIZE which will handle the size change
 770                unsafe {
 771                    SetWindowPos(
 772                        handle,
 773                        None,
 774                        work_area.left,
 775                        work_area.top,
 776                        width,
 777                        height,
 778                        SWP_NOZORDER | SWP_NOACTIVATE | SWP_FRAMECHANGED,
 779                    )
 780                    .context("unable to set maximized window position after dpi has changed")
 781                    .log_err();
 782                }
 783
 784                // SetWindowPos may not send WM_SIZE for maximized windows in some cases,
 785                // so we manually update the size to ensure proper rendering
 786                let device_size = size(DevicePixels(width), DevicePixels(height));
 787                self.handle_size_change(device_size, new_scale_factor, true);
 788            }
 789        } else {
 790            // For non-maximized windows, use the suggested RECT from the system
 791            let rect = unsafe { &*(lparam.0 as *const RECT) };
 792            let width = rect.right - rect.left;
 793            let height = rect.bottom - rect.top;
 794            // this will emit `WM_SIZE` and `WM_MOVE` right here
 795            // even before this function returns
 796            // the new size is handled in `WM_SIZE`
 797            unsafe {
 798                SetWindowPos(
 799                    handle,
 800                    None,
 801                    rect.left,
 802                    rect.top,
 803                    width,
 804                    height,
 805                    SWP_NOZORDER | SWP_NOACTIVATE,
 806                )
 807                .context("unable to set window position after dpi has changed")
 808                .log_err();
 809            }
 810        }
 811
 812        Some(0)
 813    }
 814
 815    /// The following conditions will trigger this event:
 816    /// 1. The monitor on which the window is located goes offline or changes resolution.
 817    /// 2. Another monitor goes offline, is plugged in, or changes resolution.
 818    ///
 819    /// In either case, the window will only receive information from the monitor on which
 820    /// it is located.
 821    ///
 822    /// For example, in the case of condition 2, where the monitor on which the window is
 823    /// located has actually changed nothing, it will still receive this event.
 824    fn handle_display_change_msg(&self, handle: HWND) -> Option<isize> {
 825        // NOTE:
 826        // Even the `lParam` holds the resolution of the screen, we just ignore it.
 827        // Because WM_DPICHANGED, WM_MOVE, WM_SIZE will come first, window reposition and resize
 828        // are handled there.
 829        // So we only care about if monitor is disconnected.
 830        let previous_monitor = self.state.display.get();
 831        if WindowsDisplay::is_connected(previous_monitor.handle) {
 832            // we are fine, other display changed
 833            return None;
 834        }
 835        // display disconnected
 836        // in this case, the OS will move our window to another monitor, and minimize it.
 837        // we deminimize the window and query the monitor after moving
 838        unsafe {
 839            let _ = ShowWindow(handle, SW_SHOWNORMAL);
 840        };
 841        let new_monitor = unsafe { MonitorFromWindow(handle, MONITOR_DEFAULTTONULL) };
 842        // all monitors disconnected
 843        if new_monitor.is_invalid() {
 844            log::error!("No monitor detected!");
 845            return None;
 846        }
 847        let new_display = WindowsDisplay::new_with_handle(new_monitor).log_err()?;
 848        self.state.display.set(new_display);
 849        Some(0)
 850    }
 851
 852    fn handle_hit_test_msg(&self, handle: HWND, lparam: LPARAM) -> Option<isize> {
 853        if !self.is_movable || self.state.is_fullscreen() {
 854            return None;
 855        }
 856
 857        let callback = self.state.callbacks.hit_test_window_control.take();
 858        let drag_area = if let Some(mut callback) = callback {
 859            let area = callback();
 860            self.state
 861                .callbacks
 862                .hit_test_window_control
 863                .set(Some(callback));
 864            if let Some(area) = area {
 865                match area {
 866                    WindowControlArea::Drag => Some(HTCAPTION as _),
 867                    WindowControlArea::Close => return Some(HTCLOSE as _),
 868                    WindowControlArea::Max => return Some(HTMAXBUTTON as _),
 869                    WindowControlArea::Min => return Some(HTMINBUTTON as _),
 870                }
 871            } else {
 872                None
 873            }
 874        } else {
 875            None
 876        };
 877
 878        if !self.hide_title_bar {
 879            // If the OS draws the title bar, we don't need to handle hit test messages.
 880            return drag_area;
 881        }
 882
 883        let dpi = unsafe { GetDpiForWindow(handle) };
 884        // We do not use the OS title bar, so the default `DefWindowProcW` will only register a 1px edge for resizes
 885        // We need to calculate the frame thickness ourselves and do the hit test manually.
 886        let frame_y = get_frame_thicknessx(dpi);
 887        let frame_x = get_frame_thicknessy(dpi);
 888        let mut cursor_point = POINT {
 889            x: lparam.signed_loword().into(),
 890            y: lparam.signed_hiword().into(),
 891        };
 892
 893        unsafe { ScreenToClient(handle, &mut cursor_point).ok().log_err() };
 894        if !self.state.is_maximized() && 0 <= cursor_point.y && cursor_point.y <= frame_y {
 895            // x-axis actually goes from -frame_x to 0
 896            return Some(if cursor_point.x <= 0 {
 897                HTTOPLEFT
 898            } else {
 899                let mut rect = Default::default();
 900                unsafe { GetWindowRect(handle, &mut rect) }.log_err();
 901                // right and bottom bounds of RECT are exclusive, thus `-1`
 902                let right = rect.right - rect.left - 1;
 903                // the bounds include the padding frames, so accomodate for both of them
 904                if right - 2 * frame_x <= cursor_point.x {
 905                    HTTOPRIGHT
 906                } else {
 907                    HTTOP
 908                }
 909            } as _);
 910        }
 911
 912        drag_area
 913    }
 914
 915    fn handle_nc_mouse_move_msg(&self, handle: HWND, lparam: LPARAM) -> Option<isize> {
 916        self.start_tracking_mouse(handle, TME_LEAVE | TME_NONCLIENT);
 917
 918        let mut func = self.state.callbacks.input.take()?;
 919        let scale_factor = self.state.scale_factor.get();
 920
 921        let mut cursor_point = POINT {
 922            x: lparam.signed_loword().into(),
 923            y: lparam.signed_hiword().into(),
 924        };
 925        unsafe { ScreenToClient(handle, &mut cursor_point).ok().log_err() };
 926        let input = PlatformInput::MouseMove(MouseMoveEvent {
 927            position: logical_point(cursor_point.x as f32, cursor_point.y as f32, scale_factor),
 928            pressed_button: None,
 929            modifiers: current_modifiers(),
 930        });
 931        let handled = !func(input).propagate;
 932        self.state.callbacks.input.set(Some(func));
 933
 934        if handled { Some(0) } else { None }
 935    }
 936
 937    fn handle_nc_mouse_down_msg(
 938        &self,
 939        handle: HWND,
 940        button: MouseButton,
 941        wparam: WPARAM,
 942        lparam: LPARAM,
 943    ) -> Option<isize> {
 944        if let Some(mut func) = self.state.callbacks.input.take() {
 945            let scale_factor = self.state.scale_factor.get();
 946            let mut cursor_point = POINT {
 947                x: lparam.signed_loword().into(),
 948                y: lparam.signed_hiword().into(),
 949            };
 950            unsafe { ScreenToClient(handle, &mut cursor_point).ok().log_err() };
 951            let physical_point = point(DevicePixels(cursor_point.x), DevicePixels(cursor_point.y));
 952            let click_count = self.state.click_state.update(button, physical_point);
 953
 954            let input = PlatformInput::MouseDown(MouseDownEvent {
 955                button,
 956                position: logical_point(cursor_point.x as f32, cursor_point.y as f32, scale_factor),
 957                modifiers: current_modifiers(),
 958                click_count,
 959                first_mouse: false,
 960            });
 961            let handled = !func(input).propagate;
 962            self.state.callbacks.input.set(Some(func));
 963
 964            if handled {
 965                return Some(0);
 966            }
 967        } else {
 968        };
 969
 970        // Since these are handled in handle_nc_mouse_up_msg we must prevent the default window proc
 971        if button == MouseButton::Left {
 972            match wparam.0 as u32 {
 973                HTMINBUTTON => self.state.nc_button_pressed.set(Some(HTMINBUTTON)),
 974                HTMAXBUTTON => self.state.nc_button_pressed.set(Some(HTMAXBUTTON)),
 975                HTCLOSE => self.state.nc_button_pressed.set(Some(HTCLOSE)),
 976                _ => return None,
 977            };
 978            Some(0)
 979        } else {
 980            None
 981        }
 982    }
 983
 984    fn handle_nc_mouse_up_msg(
 985        &self,
 986        handle: HWND,
 987        button: MouseButton,
 988        wparam: WPARAM,
 989        lparam: LPARAM,
 990    ) -> Option<isize> {
 991        if let Some(mut func) = self.state.callbacks.input.take() {
 992            let scale_factor = self.state.scale_factor.get();
 993
 994            let mut cursor_point = POINT {
 995                x: lparam.signed_loword().into(),
 996                y: lparam.signed_hiword().into(),
 997            };
 998            unsafe { ScreenToClient(handle, &mut cursor_point).ok().log_err() };
 999            let input = PlatformInput::MouseUp(MouseUpEvent {
1000                button,
1001                position: logical_point(cursor_point.x as f32, cursor_point.y as f32, scale_factor),
1002                modifiers: current_modifiers(),
1003                click_count: 1,
1004            });
1005            let handled = !func(input).propagate;
1006            self.state.callbacks.input.set(Some(func));
1007
1008            if handled {
1009                return Some(0);
1010            }
1011        } else {
1012        }
1013
1014        let last_pressed = self.state.nc_button_pressed.take();
1015        if button == MouseButton::Left
1016            && let Some(last_pressed) = last_pressed
1017        {
1018            let handled = match (wparam.0 as u32, last_pressed) {
1019                (HTMINBUTTON, HTMINBUTTON) => {
1020                    unsafe { ShowWindowAsync(handle, SW_MINIMIZE).ok().log_err() };
1021                    true
1022                }
1023                (HTMAXBUTTON, HTMAXBUTTON) => {
1024                    if self.state.is_maximized() {
1025                        unsafe { ShowWindowAsync(handle, SW_NORMAL).ok().log_err() };
1026                    } else {
1027                        unsafe { ShowWindowAsync(handle, SW_MAXIMIZE).ok().log_err() };
1028                    }
1029                    true
1030                }
1031                (HTCLOSE, HTCLOSE) => {
1032                    unsafe {
1033                        PostMessageW(Some(handle), WM_CLOSE, WPARAM::default(), LPARAM::default())
1034                            .log_err()
1035                    };
1036                    true
1037                }
1038                _ => false,
1039            };
1040            if handled {
1041                return Some(0);
1042            }
1043        }
1044
1045        None
1046    }
1047
1048    fn handle_cursor_changed(&self, lparam: LPARAM) -> Option<isize> {
1049        let had_cursor = self.state.current_cursor.get().is_some();
1050
1051        self.state.current_cursor.set(if lparam.0 == 0 {
1052            None
1053        } else {
1054            Some(HCURSOR(lparam.0 as _))
1055        });
1056
1057        if had_cursor != self.state.current_cursor.get().is_some() {
1058            unsafe { SetCursor(self.state.current_cursor.get()) };
1059        }
1060
1061        Some(0)
1062    }
1063
1064    fn handle_set_cursor(&self, handle: HWND, lparam: LPARAM) -> Option<isize> {
1065        if unsafe { !IsWindowEnabled(handle).as_bool() }
1066            || matches!(
1067                lparam.loword() as u32,
1068                HTLEFT
1069                    | HTRIGHT
1070                    | HTTOP
1071                    | HTTOPLEFT
1072                    | HTTOPRIGHT
1073                    | HTBOTTOM
1074                    | HTBOTTOMLEFT
1075                    | HTBOTTOMRIGHT
1076            )
1077        {
1078            return None;
1079        }
1080        unsafe {
1081            SetCursor(self.state.current_cursor.get());
1082        };
1083        Some(0)
1084    }
1085
1086    fn handle_system_settings_changed(
1087        &self,
1088        handle: HWND,
1089        wparam: WPARAM,
1090        lparam: LPARAM,
1091    ) -> Option<isize> {
1092        if wparam.0 != 0 {
1093            let display = self.state.display.get();
1094            self.state.click_state.system_update(wparam.0);
1095            self.state.border_offset.update(handle).log_err();
1096            // system settings may emit a window message which wants to take the refcell self.state, so drop it
1097
1098            self.system_settings().update(display, wparam.0);
1099        } else {
1100            self.handle_system_theme_changed(handle, lparam)?;
1101        };
1102        // Force to trigger WM_NCCALCSIZE event to ensure that we handle auto hide
1103        // taskbar correctly.
1104        notify_frame_changed(handle);
1105
1106        Some(0)
1107    }
1108
1109    fn handle_system_theme_changed(&self, handle: HWND, lparam: LPARAM) -> Option<isize> {
1110        // lParam is a pointer to a string that indicates the area containing the system parameter
1111        // that was changed.
1112        let parameter = PCWSTR::from_raw(lparam.0 as _);
1113        if unsafe { !parameter.is_null() && !parameter.is_empty() }
1114            && let Some(parameter_string) = unsafe { parameter.to_string() }.log_err()
1115        {
1116            log::info!("System settings changed: {}", parameter_string);
1117            if parameter_string.as_str() == "ImmersiveColorSet" {
1118                let new_appearance = system_appearance()
1119                    .context("unable to get system appearance when handling ImmersiveColorSet")
1120                    .log_err()?;
1121
1122                if new_appearance != self.state.appearance.get() {
1123                    self.state.appearance.set(new_appearance);
1124                    let mut callback = self.state.callbacks.appearance_changed.take()?;
1125
1126                    callback();
1127                    self.state.callbacks.appearance_changed.set(Some(callback));
1128                    configure_dwm_dark_mode(handle, new_appearance);
1129                }
1130            }
1131        }
1132        Some(0)
1133    }
1134
1135    fn handle_input_language_changed(&self) -> Option<isize> {
1136        unsafe {
1137            PostMessageW(
1138                Some(self.platform_window_handle),
1139                WM_GPUI_KEYBOARD_LAYOUT_CHANGED,
1140                WPARAM(self.validation_number),
1141                LPARAM(0),
1142            )
1143            .log_err();
1144        }
1145        Some(0)
1146    }
1147
1148    fn handle_window_visibility_changed(&self, handle: HWND, wparam: WPARAM) -> Option<isize> {
1149        if wparam.0 == 1 {
1150            self.draw_window(handle, false);
1151        }
1152        None
1153    }
1154
1155    fn handle_device_lost(&self, lparam: LPARAM) -> Option<isize> {
1156        let devices = lparam.0 as *const DirectXDevices;
1157        let devices = unsafe { &*devices };
1158        if let Err(err) = self
1159            .state
1160            .renderer
1161            .borrow_mut()
1162            .handle_device_lost(&devices)
1163        {
1164            panic!("Device lost: {err}");
1165        }
1166        Some(0)
1167    }
1168
1169    #[inline]
1170    fn draw_window(&self, handle: HWND, force_render: bool) -> Option<isize> {
1171        let mut request_frame = self.state.callbacks.request_frame.take()?;
1172
1173        // we are instructing gpui to force render a frame, this will
1174        // re-populate all the gpu textures for us so we can resume drawing in
1175        // case we disabled drawing earlier due to a device loss
1176        self.state.renderer.borrow_mut().mark_drawable();
1177        request_frame(RequestFrameOptions {
1178            require_presentation: false,
1179            force_render,
1180        });
1181
1182        self.state.callbacks.request_frame.set(Some(request_frame));
1183        unsafe { ValidateRect(Some(handle), None).ok().log_err() };
1184
1185        Some(0)
1186    }
1187
1188    #[inline]
1189    fn parse_char_message(&self, wparam: WPARAM) -> Option<String> {
1190        let code_point = wparam.loword();
1191
1192        // https://www.unicode.org/versions/Unicode16.0.0/core-spec/chapter-3/#G2630
1193        match code_point {
1194            0xD800..=0xDBFF => {
1195                // High surrogate, wait for low surrogate
1196                self.state.pending_surrogate.set(Some(code_point));
1197                None
1198            }
1199            0xDC00..=0xDFFF => {
1200                if let Some(high_surrogate) = self.state.pending_surrogate.take() {
1201                    // Low surrogate, combine with pending high surrogate
1202                    String::from_utf16(&[high_surrogate, code_point]).ok()
1203                } else {
1204                    // Invalid low surrogate without a preceding high surrogate
1205                    log::warn!(
1206                        "Received low surrogate without a preceding high surrogate: {code_point:x}"
1207                    );
1208                    None
1209                }
1210            }
1211            _ => {
1212                self.state.pending_surrogate.set(None);
1213                char::from_u32(code_point as u32)
1214                    .filter(|c| !c.is_control())
1215                    .map(|c| c.to_string())
1216            }
1217        }
1218    }
1219
1220    fn start_tracking_mouse(&self, handle: HWND, flags: TRACKMOUSEEVENT_FLAGS) {
1221        if !self.state.hovered.get() {
1222            self.state.hovered.set(true);
1223            unsafe {
1224                TrackMouseEvent(&mut TRACKMOUSEEVENT {
1225                    cbSize: std::mem::size_of::<TRACKMOUSEEVENT>() as u32,
1226                    dwFlags: flags,
1227                    hwndTrack: handle,
1228                    dwHoverTime: HOVER_DEFAULT,
1229                })
1230                .log_err()
1231            };
1232            if let Some(mut callback) = self.state.callbacks.hovered_status_change.take() {
1233                callback(true);
1234                self.state
1235                    .callbacks
1236                    .hovered_status_change
1237                    .set(Some(callback));
1238            }
1239        }
1240    }
1241
1242    fn with_input_handler<F, R>(&self, f: F) -> Option<R>
1243    where
1244        F: FnOnce(&mut PlatformInputHandler) -> R,
1245    {
1246        let mut input_handler = self.state.input_handler.take()?;
1247        let result = f(&mut input_handler);
1248        self.state.input_handler.set(Some(input_handler));
1249        Some(result)
1250    }
1251
1252    fn with_input_handler_and_scale_factor<F, R>(&self, f: F) -> Option<R>
1253    where
1254        F: FnOnce(&mut PlatformInputHandler, f32) -> Option<R>,
1255    {
1256        let mut input_handler = self.state.input_handler.take()?;
1257        let scale_factor = self.state.scale_factor.get();
1258
1259        let result = f(&mut input_handler, scale_factor);
1260        self.state.input_handler.set(Some(input_handler));
1261        result
1262    }
1263}
1264
1265fn handle_key_event<F>(
1266    wparam: WPARAM,
1267    lparam: LPARAM,
1268    state: &WindowsWindowState,
1269    f: F,
1270) -> Option<PlatformInput>
1271where
1272    F: FnOnce(Keystroke, bool) -> PlatformInput,
1273{
1274    let virtual_key = VIRTUAL_KEY(wparam.loword());
1275    let modifiers = current_modifiers();
1276
1277    match virtual_key {
1278        VK_SHIFT | VK_CONTROL | VK_MENU | VK_LMENU | VK_RMENU | VK_LWIN | VK_RWIN => {
1279            if state
1280                .last_reported_modifiers
1281                .get()
1282                .is_some_and(|prev_modifiers| prev_modifiers == modifiers)
1283            {
1284                return None;
1285            }
1286            state.last_reported_modifiers.set(Some(modifiers));
1287            Some(PlatformInput::ModifiersChanged(ModifiersChangedEvent {
1288                modifiers,
1289                capslock: current_capslock(),
1290            }))
1291        }
1292        VK_PACKET => None,
1293        VK_CAPITAL => {
1294            let capslock = current_capslock();
1295            if state
1296                .last_reported_capslock
1297                .get()
1298                .is_some_and(|prev_capslock| prev_capslock == capslock)
1299            {
1300                return None;
1301            }
1302            state.last_reported_capslock.set(Some(capslock));
1303            Some(PlatformInput::ModifiersChanged(ModifiersChangedEvent {
1304                modifiers,
1305                capslock,
1306            }))
1307        }
1308        vkey => {
1309            let keystroke = parse_normal_key(vkey, lparam, modifiers)?;
1310            Some(f(keystroke.0, keystroke.1))
1311        }
1312    }
1313}
1314
1315fn parse_immutable(vkey: VIRTUAL_KEY) -> Option<String> {
1316    Some(
1317        match vkey {
1318            VK_SPACE => "space",
1319            VK_BACK => "backspace",
1320            VK_RETURN => "enter",
1321            VK_TAB => "tab",
1322            VK_UP => "up",
1323            VK_DOWN => "down",
1324            VK_RIGHT => "right",
1325            VK_LEFT => "left",
1326            VK_HOME => "home",
1327            VK_END => "end",
1328            VK_PRIOR => "pageup",
1329            VK_NEXT => "pagedown",
1330            VK_BROWSER_BACK => "back",
1331            VK_BROWSER_FORWARD => "forward",
1332            VK_ESCAPE => "escape",
1333            VK_INSERT => "insert",
1334            VK_DELETE => "delete",
1335            VK_APPS => "menu",
1336            VK_F1 => "f1",
1337            VK_F2 => "f2",
1338            VK_F3 => "f3",
1339            VK_F4 => "f4",
1340            VK_F5 => "f5",
1341            VK_F6 => "f6",
1342            VK_F7 => "f7",
1343            VK_F8 => "f8",
1344            VK_F9 => "f9",
1345            VK_F10 => "f10",
1346            VK_F11 => "f11",
1347            VK_F12 => "f12",
1348            VK_F13 => "f13",
1349            VK_F14 => "f14",
1350            VK_F15 => "f15",
1351            VK_F16 => "f16",
1352            VK_F17 => "f17",
1353            VK_F18 => "f18",
1354            VK_F19 => "f19",
1355            VK_F20 => "f20",
1356            VK_F21 => "f21",
1357            VK_F22 => "f22",
1358            VK_F23 => "f23",
1359            VK_F24 => "f24",
1360            _ => return None,
1361        }
1362        .to_string(),
1363    )
1364}
1365
1366fn parse_normal_key(
1367    vkey: VIRTUAL_KEY,
1368    lparam: LPARAM,
1369    mut modifiers: Modifiers,
1370) -> Option<(Keystroke, bool)> {
1371    let (key_char, prefer_character_input) = process_key(vkey, lparam.hiword());
1372
1373    let key = parse_immutable(vkey).or_else(|| {
1374        let scan_code = lparam.hiword() & 0xFF;
1375        get_keystroke_key(vkey, scan_code as u32, &mut modifiers)
1376    })?;
1377
1378    Some((
1379        Keystroke {
1380            modifiers,
1381            key,
1382            key_char,
1383        },
1384        prefer_character_input,
1385    ))
1386}
1387
1388fn process_key(vkey: VIRTUAL_KEY, scan_code: u16) -> (Option<String>, bool) {
1389    let mut keyboard_state = [0u8; 256];
1390    unsafe {
1391        if GetKeyboardState(&mut keyboard_state).is_err() {
1392            return (None, false);
1393        }
1394    }
1395
1396    let mut buffer_c = [0u16; 8];
1397    let result_c = unsafe {
1398        ToUnicode(
1399            vkey.0 as u32,
1400            scan_code as u32,
1401            Some(&keyboard_state),
1402            &mut buffer_c,
1403            0x4,
1404        )
1405    };
1406
1407    if result_c == 0 {
1408        return (None, false);
1409    }
1410
1411    let c = &buffer_c[..result_c.unsigned_abs() as usize];
1412    let key_char = String::from_utf16(c)
1413        .ok()
1414        .filter(|s| !s.is_empty() && !s.chars().next().unwrap().is_control());
1415
1416    if result_c < 0 {
1417        return (key_char, true);
1418    }
1419
1420    if key_char.is_none() {
1421        return (None, false);
1422    }
1423
1424    // Workaround for some bug that makes the compiler think keyboard_state is still zeroed out
1425    let keyboard_state = std::hint::black_box(keyboard_state);
1426    let ctrl_down = (keyboard_state[VK_CONTROL.0 as usize] & 0x80) != 0;
1427    let alt_down = (keyboard_state[VK_MENU.0 as usize] & 0x80) != 0;
1428    let win_down = (keyboard_state[VK_LWIN.0 as usize] & 0x80) != 0
1429        || (keyboard_state[VK_RWIN.0 as usize] & 0x80) != 0;
1430
1431    let has_modifiers = ctrl_down || alt_down || win_down;
1432    if !has_modifiers {
1433        return (key_char, false);
1434    }
1435
1436    let mut state_no_modifiers = keyboard_state;
1437    state_no_modifiers[VK_CONTROL.0 as usize] = 0;
1438    state_no_modifiers[VK_LCONTROL.0 as usize] = 0;
1439    state_no_modifiers[VK_RCONTROL.0 as usize] = 0;
1440    state_no_modifiers[VK_MENU.0 as usize] = 0;
1441    state_no_modifiers[VK_LMENU.0 as usize] = 0;
1442    state_no_modifiers[VK_RMENU.0 as usize] = 0;
1443    state_no_modifiers[VK_LWIN.0 as usize] = 0;
1444    state_no_modifiers[VK_RWIN.0 as usize] = 0;
1445
1446    let mut buffer_c_no_modifiers = [0u16; 8];
1447    let result_c_no_modifiers = unsafe {
1448        ToUnicode(
1449            vkey.0 as u32,
1450            scan_code as u32,
1451            Some(&state_no_modifiers),
1452            &mut buffer_c_no_modifiers,
1453            0x4,
1454        )
1455    };
1456
1457    let c_no_modifiers = &buffer_c_no_modifiers[..result_c_no_modifiers.unsigned_abs() as usize];
1458    (
1459        key_char,
1460        result_c != result_c_no_modifiers || c != c_no_modifiers,
1461    )
1462}
1463
1464fn parse_ime_composition_string(ctx: HIMC, comp_type: IME_COMPOSITION_STRING) -> Option<Vec<u16>> {
1465    unsafe {
1466        let string_len = ImmGetCompositionStringW(ctx, comp_type, None, 0);
1467        if string_len >= 0 {
1468            let mut buffer = vec![0u8; string_len as usize + 2];
1469            ImmGetCompositionStringW(
1470                ctx,
1471                comp_type,
1472                Some(buffer.as_mut_ptr() as _),
1473                string_len as _,
1474            );
1475            let wstring = std::slice::from_raw_parts::<u16>(
1476                buffer.as_mut_ptr().cast::<u16>(),
1477                string_len as usize / 2,
1478            );
1479            Some(wstring.to_vec())
1480        } else {
1481            None
1482        }
1483    }
1484}
1485
1486#[inline]
1487fn retrieve_composition_cursor_position(ctx: HIMC) -> usize {
1488    unsafe { ImmGetCompositionStringW(ctx, GCS_CURSORPOS, None, 0) as usize }
1489}
1490
1491fn should_use_ime_cursor_position(ctx: HIMC, cursor_pos: usize) -> bool {
1492    let attrs_size = unsafe { ImmGetCompositionStringW(ctx, GCS_COMPATTR, None, 0) } as usize;
1493    if attrs_size == 0 {
1494        return false;
1495    }
1496
1497    let mut attrs = vec![0u8; attrs_size];
1498    let result = unsafe {
1499        ImmGetCompositionStringW(
1500            ctx,
1501            GCS_COMPATTR,
1502            Some(attrs.as_mut_ptr() as *mut _),
1503            attrs_size as u32,
1504        )
1505    };
1506    if result <= 0 {
1507        return false;
1508    }
1509
1510    // Keep the cursor adjacent to the inserted text by only using the suggested position
1511    // if it's adjacent to unconverted text.
1512    let at_cursor_is_input = cursor_pos < attrs.len() && attrs[cursor_pos] == (ATTR_INPUT as u8);
1513    let before_cursor_is_input = cursor_pos > 0
1514        && (cursor_pos - 1) < attrs.len()
1515        && attrs[cursor_pos - 1] == (ATTR_INPUT as u8);
1516
1517    at_cursor_is_input || before_cursor_is_input
1518}
1519
1520#[inline]
1521fn is_virtual_key_pressed(vkey: VIRTUAL_KEY) -> bool {
1522    unsafe { GetKeyState(vkey.0 as i32) < 0 }
1523}
1524
1525#[inline]
1526pub(crate) fn current_modifiers() -> Modifiers {
1527    Modifiers {
1528        control: is_virtual_key_pressed(VK_CONTROL),
1529        alt: is_virtual_key_pressed(VK_MENU),
1530        shift: is_virtual_key_pressed(VK_SHIFT),
1531        platform: is_virtual_key_pressed(VK_LWIN) || is_virtual_key_pressed(VK_RWIN),
1532        function: false,
1533    }
1534}
1535
1536#[inline]
1537pub(crate) fn current_capslock() -> Capslock {
1538    let on = unsafe { GetKeyState(VK_CAPITAL.0 as i32) & 1 } > 0;
1539    Capslock { on }
1540}
1541
1542fn get_client_area_insets(
1543    handle: HWND,
1544    is_maximized: bool,
1545    windows_version: WindowsVersion,
1546) -> RECT {
1547    // For maximized windows, Windows outdents the window rect from the screen's client rect
1548    // by `frame_thickness` on each edge, meaning `insets` must contain `frame_thickness`
1549    // on all sides (including the top) to avoid the client area extending onto adjacent
1550    // monitors.
1551    //
1552    // For non-maximized windows, things become complicated:
1553    //
1554    // - On Windows 10
1555    // The top inset must be zero, since if there is any nonclient area, Windows will draw
1556    // a full native titlebar outside the client area. (This doesn't occur in the maximized
1557    // case.)
1558    //
1559    // - On Windows 11
1560    // The top inset is calculated using an empirical formula that I derived through various
1561    // tests. Without this, the top 1-2 rows of pixels in our window would be obscured.
1562    let dpi = unsafe { GetDpiForWindow(handle) };
1563    let frame_thickness = get_frame_thicknessx(dpi);
1564    let top_insets = if is_maximized {
1565        frame_thickness
1566    } else {
1567        match windows_version {
1568            WindowsVersion::Win10 => 0,
1569            WindowsVersion::Win11 => (dpi as f32 / USER_DEFAULT_SCREEN_DPI as f32).round() as i32,
1570        }
1571    };
1572    RECT {
1573        left: frame_thickness,
1574        top: top_insets,
1575        right: frame_thickness,
1576        bottom: frame_thickness,
1577    }
1578}
1579
1580// there is some additional non-visible space when talking about window
1581// borders on Windows:
1582// - SM_CXSIZEFRAME: The resize handle.
1583// - SM_CXPADDEDBORDER: Additional border space that isn't part of the resize handle.
1584fn get_frame_thicknessx(dpi: u32) -> i32 {
1585    let resize_frame_thickness = unsafe { GetSystemMetricsForDpi(SM_CXSIZEFRAME, dpi) };
1586    let padding_thickness = unsafe { GetSystemMetricsForDpi(SM_CXPADDEDBORDER, dpi) };
1587    resize_frame_thickness + padding_thickness
1588}
1589
1590fn get_frame_thicknessy(dpi: u32) -> i32 {
1591    let resize_frame_thickness = unsafe { GetSystemMetricsForDpi(SM_CYSIZEFRAME, dpi) };
1592    let padding_thickness = unsafe { GetSystemMetricsForDpi(SM_CXPADDEDBORDER, dpi) };
1593    resize_frame_thickness + padding_thickness
1594}
1595
1596fn notify_frame_changed(handle: HWND) {
1597    unsafe {
1598        SetWindowPos(
1599            handle,
1600            None,
1601            0,
1602            0,
1603            0,
1604            0,
1605            SWP_FRAMECHANGED
1606                | SWP_NOACTIVATE
1607                | SWP_NOCOPYBITS
1608                | SWP_NOMOVE
1609                | SWP_NOOWNERZORDER
1610                | SWP_NOREPOSITION
1611                | SWP_NOSENDCHANGING
1612                | SWP_NOSIZE
1613                | SWP_NOZORDER,
1614        )
1615        .log_err();
1616    }
1617}