1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117
use core::ffi::c_void;
use core::num::NonZeroIsize;
use core::ptr::NonNull;
use super::DisplayHandle;
/// Raw display handle for Windows.
///
/// It can be used regardless of Windows window backend.
#[non_exhaustive]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct WindowsDisplayHandle {}
impl WindowsDisplayHandle {
/// Create a new empty display handle.
///
///
/// # Example
///
/// ```
/// # use raw_window_handle::WindowsDisplayHandle;
/// let handle = WindowsDisplayHandle::new();
/// ```
pub fn new() -> Self {
Self {}
}
}
impl DisplayHandle<'static> {
/// Create a Windows-based display handle.
///
/// As no data is borrowed by this handle, it is completely safe to create. This function
/// may be useful to windowing framework implementations that want to avoid unsafe code.
///
/// # Example
///
/// ```
/// # use raw_window_handle::{DisplayHandle, HasDisplayHandle};
/// # fn do_something(rwh: impl HasDisplayHandle) { let _ = rwh; }
/// let handle = DisplayHandle::windows();
/// do_something(handle);
/// ```
pub fn windows() -> Self {
// SAFETY: No data is borrowed.
unsafe { Self::borrow_raw(WindowsDisplayHandle::new().into()) }
}
}
/// Raw window handle for Win32.
#[non_exhaustive]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct Win32WindowHandle {
/// A Win32 `HWND` handle.
pub hwnd: NonZeroIsize,
/// The `GWLP_HINSTANCE` associated with this type's `HWND`.
pub hinstance: Option<NonZeroIsize>,
}
impl Win32WindowHandle {
/// Create a new handle to a window.
///
/// # Safety
///
/// It is assumed that the Win32 handle belongs to the current thread. This
/// is necessary for the handle to be considered "valid" in all cases.
///
/// # Example
///
/// ```
/// # use core::num::NonZeroIsize;
/// # use raw_window_handle::Win32WindowHandle;
/// # struct HWND(isize);
/// #
/// let window: HWND;
/// # window = HWND(1);
/// let mut handle = Win32WindowHandle::new(NonZeroIsize::new(window.0).unwrap());
/// // Optionally set the GWLP_HINSTANCE.
/// # #[cfg(only_for_showcase)]
/// let hinstance = NonZeroIsize::new(unsafe { GetWindowLongPtrW(window, GWLP_HINSTANCE) }).unwrap();
/// # let hinstance = None;
/// handle.hinstance = hinstance;
/// ```
pub fn new(hwnd: NonZeroIsize) -> Self {
Self {
hwnd,
hinstance: None,
}
}
}
/// Raw window handle for WinRT.
#[non_exhaustive]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct WinRtWindowHandle {
/// A WinRT `CoreWindow` handle.
pub core_window: NonNull<c_void>,
}
impl WinRtWindowHandle {
/// Create a new handle to a window.
///
///
/// # Example
///
/// ```
/// # use core::ptr::NonNull;
/// # use raw_window_handle::WinRtWindowHandle;
/// # type CoreWindow = ();
/// #
/// let window: NonNull<CoreWindow>;
/// # window = NonNull::from(&());
/// let handle = WinRtWindowHandle::new(window.cast());
/// ```
pub fn new(core_window: NonNull<c_void>) -> Self {
Self { core_window }
}
}