leyoda/winit
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Document Window Drop behavior (#3315)

Browse source
This commit is contained in:
daxpedda 2024-01-17 23:17:36 +01:00 • committed by GitHub
parent d1717b6a01
commit aec608f93c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 9 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

10
src/window.rs
View file

@ -19,6 +19,7 @@ use serde::{Deserialize, Serialize};
/// Represents a window. /// Represents a window.
/// ///
/// The window is closed when dropped.
/// ///
/// # Threading /// # Threading
/// ///
@ -30,7 +31,6 @@ use serde::{Deserialize, Serialize};
/// window from a thread other than the main, the code is scheduled to run on /// window from a thread other than the main, the code is scheduled to run on
/// the main thread, and your thread may be blocked until that completes. /// the main thread, and your thread may be blocked until that completes.
/// ///
///
/// # Example /// # Example
/// ///
/// ```no_run /// ```no_run
@ -54,6 +54,11 @@ use serde::{Deserialize, Serialize};
/// } /// }
/// }); /// });
/// ``` /// ```
///
/// ## Platform-specific
///
/// **Web:** The [`Window`], which is represented by a `HTMLElementCanvas`, can
/// not be closed by dropping the [`Window`].
pub struct Window { pub struct Window {
pub(crate) window: platform_impl::Window, pub(crate) window: platform_impl::Window,
} }
@ -65,6 +70,9 @@ impl fmt::Debug for Window {
} }
impl Drop for Window { impl Drop for Window {
/// This will close the [`Window`].
///
/// See [`Window`] for more details.
fn drop(&mut self) { fn drop(&mut self) {
self.window.maybe_wait_on_main(|w| { self.window.maybe_wait_on_main(|w| {
// If the window is in exclusive fullscreen, we must restore the desktop // If the window is in exclusive fullscreen, we must restore the desktop