async_winit/

window.rs

/*

`async-winit` is free software: you can redistribute it and/or modify it under the terms of one of
the following licenses:

* GNU Lesser General Public License as published by the Free Software Foundation, either
  version 3 of the License, or (at your option) any later version.
* Mozilla Public License as published by the Mozilla Foundation, version 2.

`async-winit` is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General
Public License and the Patron License for more details.

You should have received a copy of the GNU Lesser General Public License and the Mozilla
Public License along with `async-winit`. If not, see <https://www.gnu.org/licenses/>.

*/

// This file is partially derived from `winit`, which was originally created by Pierre Krieger and
// contributers. It was originally released under the MIT license.

//! Window code adapted for `async` usage.

use crate::dpi::{Position, Size};
use crate::error::OsError;
use crate::handler::Handler;
use crate::oneoff::oneoff;
use crate::reactor::{EventLoopOp, Reactor};
use crate::sync::{ThreadSafety, __private::Rc};

pub(crate) mod registration;

use registration::Registration;

use winit::dpi::{PhysicalPosition, PhysicalSize};
use winit::error::{ExternalError, NotSupportedError};
use winit::event::DeviceId;
use winit::monitor::MonitorHandle;

#[doc(inline)]
pub use winit::window::{
    CursorGrabMode, CursorIcon, Fullscreen, Icon, ImePurpose, ResizeDirection, Theme,
    UserAttentionType, WindowButtons, WindowLevel,
};

/// Attributes to use when creating a window.
#[derive(Debug, Clone)]
pub struct WindowAttributes {
    pub inner_size: Option<Size>,
    pub min_inner_size: Option<Size>,
    pub max_inner_size: Option<Size>,
    pub position: Option<Position>,
    pub resizable: bool,
    pub enabled_buttons: WindowButtons,
    pub title: String,
    pub fullscreen: Option<Fullscreen>,
    pub maximized: bool,
    pub visible: bool,
    pub transparent: bool,
    pub decorations: bool,
    pub window_icon: Option<Icon>,
    pub preferred_theme: Option<Theme>,
    pub resize_increments: Option<Size>,
    pub content_protected: bool,
    pub window_level: WindowLevel,
    pub active: bool,
}

impl Default for WindowAttributes {
    #[inline]
    fn default() -> WindowAttributes {
        WindowAttributes {
            inner_size: None,
            min_inner_size: None,
            max_inner_size: None,
            position: None,
            resizable: true,
            enabled_buttons: WindowButtons::all(),
            title: "winit window".to_owned(),
            maximized: false,
            fullscreen: None,
            visible: true,
            transparent: false,
            decorations: true,
            window_level: Default::default(),
            window_icon: None,
            preferred_theme: None,
            resize_increments: None,
            content_protected: false,
            active: true,
        }
    }
}

/// A builder to use to create windows.
#[derive(Default)]
pub struct WindowBuilder {
    window: WindowAttributes,
    pub(crate) platform: crate::platform::PlatformSpecific,
}

impl WindowBuilder {
    /// Create a new window builder.
    pub fn new() -> WindowBuilder {
        WindowBuilder::default()
    }

    pub fn attributes(&self) -> &WindowAttributes {
        &self.window
    }

    /// Get the current window attributes.
    pub fn window_attributes(&self) -> &WindowAttributes {
        &self.window
    }

    /// Requests the window to be of specific dimensions.
    ///
    /// If this is not set, some platform-specific dimensions will be used.
    ///
    /// See [`Window::set_inner_size`] for details.
    #[inline]
    pub fn with_inner_size<S: Into<Size>>(mut self, size: S) -> Self {
        self.window.inner_size = Some(size.into());
        self
    }

    /// Sets the minimum dimensions a window can have.
    ///
    /// If this is not set, the window will have no minimum dimensions (aside
    /// from reserved).
    ///
    /// See [`Window::set_min_inner_size`] for details.
    #[inline]
    pub fn with_min_inner_size<S: Into<Size>>(mut self, min_size: S) -> Self {
        self.window.min_inner_size = Some(min_size.into());
        self
    }

    /// Sets the maximum dimensions a window can have.
    ///
    /// If this is not set, the window will have no maximum or will be set to
    /// the primary monitor's dimensions by the platform.
    ///
    /// See [`Window::set_max_inner_size`] for details.
    #[inline]
    pub fn with_max_inner_size<S: Into<Size>>(mut self, max_size: S) -> Self {
        self.window.max_inner_size = Some(max_size.into());
        self
    }

    /// Sets a desired initial position for the window.
    ///
    /// If this is not set, some platform-specific position will be chosen.
    ///
    /// See [`Window::set_outer_position`] for details.
    ///
    /// ## Platform-specific
    ///
    /// - **macOS:** The top left corner position of the window content, the
    ///   window's "inner" position. The window title bar will be placed above
    ///   it. The window will be positioned such that it fits on screen,
    ///   maintaining set `inner_size` if any.
    ///   If you need to precisely position the top left corner of the whole
    ///   window you have to use [`Window::set_outer_position`] after creating
    ///   the window.
    /// - **Windows:** The top left corner position of the window title bar,
    ///   the window's "outer" position.
    ///   There may be a small gap between this position and the window due to
    ///   the specifics of the Window Manager.
    /// - **X11:** The top left corner of the window, the window's "outer"
    ///   position.
    /// - **Others:** Ignored.
    #[inline]
    pub fn with_position<P: Into<Position>>(mut self, position: P) -> Self {
        self.window.position = Some(position.into());
        self
    }

    /// Sets whether the window is resizable or not.
    ///
    /// The default is `true`.
    ///
    /// See [`Window::set_resizable`] for details.
    #[inline]
    pub fn with_resizable(mut self, resizable: bool) -> Self {
        self.window.resizable = resizable;
        self
    }

    /// Sets the enabled window buttons.
    ///
    /// The default is [`WindowButtons::all`]
    ///
    /// See `Window::set_enabled_buttons` for details.
    #[inline]
    pub fn with_enabled_buttons(mut self, buttons: WindowButtons) -> Self {
        self.window.enabled_buttons = buttons;
        self
    }

    /// Sets the initial title of the window in the title bar.
    ///
    /// The default is `"winit window"`.
    ///
    /// See [`Window::set_title`] for details.
    #[inline]
    pub fn with_title<T: Into<String>>(mut self, title: T) -> Self {
        self.window.title = title.into();
        self
    }

    /// Sets whether the window should be put into fullscreen upon creation.
    ///
    /// The default is `None`.
    ///
    /// See [`Window::set_fullscreen`] for details.
    #[inline]
    pub fn with_fullscreen(mut self, fullscreen: Option<Fullscreen>) -> Self {
        self.window.fullscreen = fullscreen;
        self
    }

    /// Request that the window is maximized upon creation.
    ///
    /// The default is `false`.
    ///
    /// See [`Window::set_maximized`] for details.
    #[inline]
    pub fn with_maximized(mut self, maximized: bool) -> Self {
        self.window.maximized = maximized;
        self
    }

    /// Sets whether the window will be initially visible or hidden.
    ///
    /// The default is to show the window.
    ///
    /// See [`Window::set_visible`] for details.
    #[inline]
    pub fn with_visible(mut self, visible: bool) -> Self {
        self.window.visible = visible;
        self
    }

    /// Sets whether the background of the window should be transparent.
    ///
    /// If this is `true`, writing colors with alpha values different than
    /// `1.0` will produce a transparent window. On some platforms this
    /// is more of a hint for the system and you'd still have the alpha
    /// buffer. To control it see [`Window::set_transparent`].
    ///
    /// The default is `false`.
    #[inline]
    pub fn with_transparent(mut self, transparent: bool) -> Self {
        self.window.transparent = transparent;
        self
    }

    /// Get whether the window will support transparency.
    #[inline]
    pub fn transparent(&self) -> bool {
        self.window.transparent
    }

    /// Sets whether the window should have a border, a title bar, etc.
    ///
    /// The default is `true`.
    ///
    /// See [`Window::set_decorations`] for details.
    #[inline]
    pub fn with_decorations(mut self, decorations: bool) -> Self {
        self.window.decorations = decorations;
        self
    }

    /// Sets the window level.
    ///
    /// This is just a hint to the OS, and the system could ignore it.
    ///
    /// The default is [`WindowLevel::Normal`].
    ///
    /// See [`WindowLevel`] for details.
    #[inline]
    pub fn with_window_level(mut self, level: WindowLevel) -> Self {
        self.window.window_level = level;
        self
    }

    /// Sets the window icon.
    ///
    /// The default is `None`.
    ///
    /// See [`Window::set_window_icon`] for details.
    #[inline]
    pub fn with_window_icon(mut self, window_icon: Option<Icon>) -> Self {
        self.window.window_icon = window_icon;
        self
    }

    /// Sets a specific theme for the window.
    ///
    /// If `None` is provided, the window will use the system theme.
    ///
    /// The default is `None`.
    ///
    /// ## Platform-specific
    ///
    /// - **macOS:** This is an app-wide setting.
    /// - **Wayland:** This control only CSD. You can also use `WINIT_WAYLAND_CSD_THEME` env variable to set the theme.
    ///   Possible values for env variable are: "dark" and light".
    /// - **x11:** Build window with `_GTK_THEME_VARIANT` hint set to `dark` or `light`.
    /// - **iOS / Android / Web / x11 / Orbital:** Ignored.
    #[inline]
    pub fn with_theme(mut self, theme: Option<Theme>) -> Self {
        self.window.preferred_theme = theme;
        self
    }

    /// Build window with resize increments hint.
    ///
    /// The default is `None`.
    ///
    /// See [`Window::set_resize_increments`] for details.
    #[inline]
    pub fn with_resize_increments<S: Into<Size>>(mut self, resize_increments: S) -> Self {
        self.window.resize_increments = Some(resize_increments.into());
        self
    }

    /// Prevents the window contents from being captured by other apps.
    ///
    /// The default is `false`.
    ///
    /// ## Platform-specific
    ///
    /// - **macOS**: if `false`, [`NSWindowSharingNone`] is used but doesn't completely
    /// prevent all apps from reading the window content, for instance, QuickTime.
    /// - **iOS / Android / Web / x11 / Orbital:** Ignored.
    ///
    /// [`NSWindowSharingNone`]: https://developer.apple.com/documentation/appkit/nswindowsharingtype/nswindowsharingnone
    #[inline]
    pub fn with_content_protected(mut self, protected: bool) -> Self {
        self.window.content_protected = protected;
        self
    }

    /// Whether the window will be initially focused or not.
    ///
    /// The window should be assumed as not focused by default
    /// following by the [`WindowEvent::Focused`].
    ///
    /// ## Platform-specific:
    ///
    /// **Android / iOS / X11 / Wayland / Orbital:** Unsupported.
    ///
    /// [`WindowEvent::Focused`]: crate::event::WindowEvent::Focused.
    #[inline]
    pub fn with_active(mut self, active: bool) -> WindowBuilder {
        self.window.active = active;
        self
    }

    /// Build a new window.
    pub async fn build<TS: ThreadSafety>(self) -> Result<Window<TS>, OsError> {
        let (tx, rx) = oneoff();
        let reactor = TS::get_reactor();
        reactor
            .push_event_loop_op(EventLoopOp::BuildWindow {
                builder: Box::new(self),
                waker: tx,
            })
            .await;

        let inner = rx.recv().await?;

        // Insert the window into the global window map.
        let registration = reactor.insert_window(inner.id());

        Ok(Window {
            inner: TS::Rc::new(inner),
            registration,
            reactor,
        })
    }

    pub(crate) fn into_winit_builder(self) -> winit::window::WindowBuilder {
        let mut builder = winit::window::WindowBuilder::new();

        if let Some(size) = self.window.inner_size {
            builder = builder.with_inner_size(size);
        }

        if let Some(size) = self.window.min_inner_size {
            builder = builder.with_min_inner_size(size);
        }

        if let Some(size) = self.window.max_inner_size {
            builder = builder.with_max_inner_size(size);
        }

        if let Some(position) = self.window.position {
            builder = builder.with_position(position);
        }

        builder = builder
            .with_resizable(self.window.resizable)
            .with_enabled_buttons(self.window.enabled_buttons)
            .with_title(&self.window.title)
            .with_fullscreen(self.window.fullscreen.clone())
            .with_maximized(self.window.maximized)
            .with_visible(self.window.visible)
            .with_transparent(self.window.transparent)
            .with_decorations(self.window.decorations);

        if let Some(icon) = self.window.window_icon.clone() {
            builder = builder.with_window_icon(Some(icon));
        }

        builder = builder.with_theme(self.window.preferred_theme);

        if let Some(size) = self.window.resize_increments {
            builder = builder.with_resize_increments(size);
        }

        builder = builder
            .with_content_protected(self.window.content_protected)
            .with_window_level(self.window.window_level)
            .with_active(self.window.active);

        builder = self.platform.apply_to(builder);

        builder
    }
}

/// A window.
#[derive(Clone)]
pub struct Window<TS: ThreadSafety> {
    /// Underlying window.
    inner: TS::Rc<winit::window::Window>,

    /// Registration for the window.
    registration: TS::Rc<Registration<TS>>,

    /// Underlying window reactor.
    reactor: TS::Rc<Reactor<TS>>,
}

impl<TS: ThreadSafety> Drop for Window<TS> {
    fn drop(&mut self) {
        self.reactor.remove_window(self.inner.id());
    }
}

unsafe impl<TS: ThreadSafety> raw_window_handle::HasRawDisplayHandle for Window<TS> {
    fn raw_display_handle(&self) -> raw_window_handle::RawDisplayHandle {
        self.inner.raw_display_handle()
    }
}

unsafe impl<TS: ThreadSafety> raw_window_handle::HasRawWindowHandle for Window<TS> {
    fn raw_window_handle(&self) -> raw_window_handle::RawWindowHandle {
        self.inner.raw_window_handle()
    }
}

impl<TS: ThreadSafety> Window<TS> {
    /// Create a new window.
    pub async fn new() -> Result<Window<TS>, OsError> {
        WindowBuilder::new().build().await
    }

    /// Get a reference to the underlying window.
    pub fn window(&self) -> &winit::window::Window {
        &self.inner
    }

    /// Get the ID of the window.
    pub fn id(&self) -> winit::window::WindowId {
        self.inner.id()
    }

    /// Get the scale factor of the window.
    pub fn scale_factor(&self) -> f64 {
        self.inner.scale_factor()
    }

    /// Request a redraw.
    pub fn request_redraw(&self) {
        self.inner.request_redraw();
    }
}

impl<TS: ThreadSafety> Window<TS> {
    /// Get the inner position of the window.
    pub async fn inner_position(&self) -> Result<PhysicalPosition<i32>, NotSupportedError> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::InnerPosition {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the outer position of the window.
    pub async fn outer_position(&self) -> Result<PhysicalPosition<i32>, NotSupportedError> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::OuterPosition {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the outer position of the window.
    pub async fn set_outer_position(&self, position: impl Into<Position>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetOuterPosition {
                window: self.inner.clone(),
                position: position.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the inner size of the window.
    pub async fn inner_size(&self) -> PhysicalSize<u32> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::InnerSize {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the outer size of the window.
    pub async fn outer_size(&self) -> PhysicalSize<u32> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::OuterSize {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the inner size of the window.
    pub async fn set_inner_size(&self, size: impl Into<Size>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetInnerSize {
                window: self.inner.clone(),
                size: size.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the minimum inner size of the window.
    pub async fn set_min_inner_size(&self, size: impl Into<Option<Size>>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetMinInnerSize {
                window: self.inner.clone(),
                size: size.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the maximum inner size of the window.
    pub async fn set_max_inner_size(&self, size: impl Into<Option<Size>>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetMaxInnerSize {
                window: self.inner.clone(),
                size: size.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the resize increments of the window.
    pub async fn resize_increments(&self) -> Option<PhysicalSize<u32>> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::ResizeIncrements {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the resize increments of the window.
    pub async fn set_resize_increments(&self, size: impl Into<Option<Size>>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetResizeIncrements {
                window: self.inner.clone(),
                size: size.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the title of the window.
    pub async fn set_title(&self, title: impl Into<String>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetTitle {
                window: self.inner.clone(),
                title: title.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set whether the window is visible.
    pub async fn set_visible(&self, visible: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetVisible {
                window: self.inner.clone(),
                visible,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the window's visibility.
    pub async fn is_visible(&self) -> Option<bool> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Visible {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's transparency.
    pub async fn set_transparent(&self, transparent: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetTransparent {
                window: self.inner.clone(),
                transparent,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's resizable property.
    pub async fn set_resizable(&self, resizable: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetResizable {
                window: self.inner.clone(),
                resizable,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the window's resizable property.
    pub async fn is_resizable(&self) -> bool {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Resizable {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's minimization.
    pub async fn set_minimized(&self, minimized: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetMinimized {
                window: self.inner.clone(),
                minimized,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the window's minimization.
    pub async fn is_minimized(&self) -> Option<bool> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Minimized {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's maximization.
    pub async fn set_maximized(&self, maximized: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetMaximized {
                window: self.inner.clone(),
                maximized,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the window's maximization.
    pub async fn is_maximized(&self) -> bool {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Maximized {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's fullscreen state.
    pub async fn set_fullscreen(&self, fullscreen: Option<Fullscreen>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetFullscreen {
                window: self.inner.clone(),
                fullscreen,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the fullscreen state of the window.
    pub async fn fullscreen(&self) -> Option<Fullscreen> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Fullscreen {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's decorations.
    pub async fn set_decorations(&self, decorations: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetDecorated {
                window: self.inner.clone(),
                decorated: decorations,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the window's decorations.
    pub async fn is_decorated(&self) -> bool {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Decorated {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window level.
    pub async fn set_window_level(&self, level: WindowLevel) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetWindowLevel {
                window: self.inner.clone(),
                level,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window icon.
    pub async fn set_window_icon(&self, icon: Option<Icon>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetWindowIcon {
                window: self.inner.clone(),
                icon,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the IME position.
    pub async fn set_ime_position(&self, posn: impl Into<Position>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetImePosition {
                window: self.inner.clone(),
                position: posn.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set whether IME is allowed.
    pub async fn set_ime_allowed(&self, allowed: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetImeAllowed {
                window: self.inner.clone(),
                allowed,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the IME purpose.
    pub async fn set_ime_purpose(&self, purpose: ImePurpose) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetImePurpose {
                window: self.inner.clone(),
                purpose,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Focus the window.
    pub async fn focus_window(&self) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::FocusWindow {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Tell whether the window is focused.
    pub async fn is_focused(&self) -> bool {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Focused {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Request the user's attention.
    pub async fn request_user_attention(&self, request_type: Option<UserAttentionType>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::RequestUserAttention {
                window: self.inner.clone(),
                request_type,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's theme.
    pub async fn set_theme(&self, theme: Option<Theme>) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetTheme {
                window: self.inner.clone(),
                theme,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the window's theme.
    pub async fn theme(&self) -> Option<Theme> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Theme {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the window's protected content.
    pub async fn set_content_protected(&self, protected: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetProtectedContent {
                window: self.inner.clone(),
                protected,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the title of the window.
    pub async fn title(&self) -> String {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::Title {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the cursor icon.
    pub async fn set_cursor_icon(&self, icon: CursorIcon) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetCursorIcon {
                window: self.inner.clone(),
                icon,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the cursor position.
    pub async fn set_cursor_position(
        &self,
        posn: impl Into<Position>,
    ) -> Result<(), ExternalError> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetCursorPosition {
                window: self.inner.clone(),
                position: posn.into(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the cursor's grab mode.
    pub async fn set_cursor_grab(&self, mode: CursorGrabMode) -> Result<(), ExternalError> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetCursorGrab {
                window: self.inner.clone(),
                mode,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the cursor's visibility.
    pub async fn set_cursor_visible(&self, visible: bool) {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetCursorVisible {
                window: self.inner.clone(),
                visible,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Drag the window.
    pub async fn drag_window(&self) -> Result<(), ExternalError> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::DragWindow {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Drag-resize the window.
    pub async fn drag_resize_window(
        &self,
        direction: ResizeDirection,
    ) -> Result<(), ExternalError> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::DragResizeWindow {
                window: self.inner.clone(),
                direction,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Set the cursor hit test.
    pub async fn set_cursor_hittest(&self, hit_test: bool) -> Result<(), ExternalError> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::SetCursorHitTest {
                window: self.inner.clone(),
                hit_test,
                waker: tx,
            })
            .await;

        rx.recv().await
    }

    /// Get the current monitor of this window.
    pub async fn current_monitor(&self) -> Option<MonitorHandle> {
        let (tx, rx) = oneoff();
        self.reactor
            .push_event_loop_op(EventLoopOp::CurrentMonitor {
                window: self.inner.clone(),
                waker: tx,
            })
            .await;

        rx.recv().await
    }
}

/// Waiting for events.
impl<TS: ThreadSafety> Window<TS> {
    /// Get the handler for the `RedrawRequested` event.
    pub fn redraw_requested(&self) -> &Handler<(), TS> {
        &self.registration.redraw_requested
    }

    /// Get the handler for the `CloseRequested` event.
    pub fn close_requested(&self) -> &Handler<(), TS> {
        &self.registration.close_requested
    }

    /// Get the handler for the `Resized` event.
    pub fn resized(&self) -> &Handler<PhysicalSize<u32>, TS> {
        &self.registration.resized
    }

    /// Get the handler for the `Moved` event.
    pub fn moved(&self) -> &Handler<PhysicalPosition<i32>, TS> {
        &self.registration.moved
    }

    /// Get handler for the `Destroyed` event.
    pub fn destroyed(&self) -> &Handler<(), TS> {
        &self.registration.destroyed
    }

    /// Get the handler for the `Focused` event.
    pub fn focused(&self) -> &Handler<bool, TS> {
        &self.registration.focused
    }

    /// Get the handler for the `KeyboardInput` event.
    pub fn keyboard_input(&self) -> &Handler<crate::event::KeyboardInput, TS> {
        &self.registration.keyboard_input
    }

    /// Get the handler for the `ModifiersChanged` event.
    pub fn modifiers_changed(&self) -> &Handler<crate::event::ModifiersState, TS> {
        &self.registration.modifiers_changed
    }

    /// Get the handler for the `ReceivedCharacter` event.
    pub fn received_character(&self) -> &Handler<char, TS> {
        &self.registration.received_character
    }

    /// Get the handler for the `Ime` event.
    pub fn ime(&self) -> &Handler<crate::event::Ime, TS> {
        &self.registration.ime
    }

    /// Get the handler for the `CursorMoved` event.
    pub fn cursor_moved(&self) -> &Handler<crate::event::CursorMoved, TS> {
        &self.registration.cursor_moved
    }

    /// Get the handler for the `CursorEntered` event.
    pub fn cursor_entered(&self) -> &Handler<DeviceId, TS> {
        &self.registration.cursor_entered
    }

    /// Get the handler for the `CursorLeft` event.
    pub fn cursor_left(&self) -> &Handler<DeviceId, TS> {
        &self.registration.cursor_left
    }

    /// Get the handle for the `MouseWheel` event.
    pub fn mouse_wheel(&self) -> &Handler<crate::event::MouseWheel, TS> {
        &self.registration.mouse_wheel
    }

    /// Get the handle for the `MouseInput` event.
    pub fn mouse_input(&self) -> &Handler<crate::event::MouseInput, TS> {
        &self.registration.mouse_input
    }

    /// Get the handle for the `TouchpadMagnify` event.
    pub fn touchpad_magnify(&self) -> &Handler<crate::event::TouchpadMagnify, TS> {
        &self.registration.touchpad_magnify
    }

    /// Get the handle for the `TouchpadPressure` event.
    pub fn touchpad_pressure(&self) -> &Handler<crate::event::TouchpadPressure, TS> {
        &self.registration.touchpad_pressure
    }

    /// Get the handle for the `Touch` event.
    pub fn touch(&self) -> &Handler<crate::event::Touch, TS> {
        &self.registration.touch
    }

    /// Get the handle for the `ScaleFactorChanged` event.
    pub fn scale_factor_changed(&self) -> &Handler<crate::event::ScaleFactor, TS> {
        &self.registration.scale_factor_changed
    }

    /// Get the handle for the `TouchpadRotate` event.
    pub fn touchpad_rotate(&self) -> &Handler<crate::event::TouchpadRotate, TS> {
        &self.registration.touchpad_rotate
    }

    /// Get the handle for the `SmartMagnify` event.
    pub fn smart_magnify(&self) -> &Handler<DeviceId, TS> {
        &self.registration.smart_magnify
    }

    /// Get the handle for the `AxisMotion` event.
    pub fn axis_motion(&self) -> &Handler<crate::event::AxisMotion, TS> {
        &self.registration.axis_motion
    }

    /// Get the handle for the `ThemeChanged` event.
    pub fn theme_changed(&self) -> &Handler<Theme, TS> {
        &self.registration.theme_changed
    }

    /// Get the handle for the `Occulded` event.
    pub fn occluded(&self) -> &Handler<bool, TS> {
        &self.registration.occluded
    }
}