#[non_exhaustive]pub enum RawWindowHandle {
Show 16 variants
UiKit(UiKitWindowHandle),
AppKit(AppKitWindowHandle),
Orbital(OrbitalWindowHandle),
OhosNdk(OhosNdkWindowHandle),
Xlib(XlibWindowHandle),
Xcb(XcbWindowHandle),
Wayland(WaylandWindowHandle),
Drm(DrmWindowHandle),
Gbm(GbmWindowHandle),
Win32(Win32WindowHandle),
WinRt(WinRtWindowHandle),
Web(WebWindowHandle),
WebCanvas(WebCanvasWindowHandle),
WebOffscreenCanvas(WebOffscreenCanvasWindowHandle),
AndroidNdk(AndroidNdkWindowHandle),
Haiku(HaikuWindowHandle),
}
Expand description
A window handle for a particular windowing system.
Each variant contains a struct with fields specific to that windowing system
(e.g. Win32WindowHandle
will include a HWND, WaylandWindowHandle
uses wl_surface,
etc.)
§Variant Availability
Note that all variants are present on all targets (none are disabled behind
#[cfg]
s), but see the “Availability Hints” section on each variant for
some hints on where this variant might be expected.
Note that these “Availability Hints” are not normative. That is to say, a
HasWindowHandle
implementor is completely allowed to return something
unexpected. (For example, it’s legal for someone to return a
RawWindowHandle::Xlib
on macOS, it would just be weird, and probably
requires something like XQuartz be used).
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
UiKit(UiKitWindowHandle)
A raw window handle for UIKit (Apple’s non-macOS windowing library).
§Availability Hints
This variant is likely to be used on iOS, tvOS, (in theory) watchOS, and
Mac Catalyst ($arch-apple-ios-macabi
targets, which can notably use
UIKit or AppKit), as these are the targets that (currently) support
UIKit.
AppKit(AppKitWindowHandle)
A raw window handle for AppKit.
§Availability Hints
This variant is likely to be used on macOS, although Mac Catalyst
($arch-apple-ios-macabi
targets, which can notably use UIKit or
AppKit) can also use it despite being target_os = "ios"
.
Orbital(OrbitalWindowHandle)
A raw window handle for the Redox operating system.
§Availability Hints
This variant is used by the Orbital Windowing System in the Redox operating system.
OhosNdk(OhosNdkWindowHandle)
A raw window handle for the OpenHarmony OS NDK
§Availability Hints
This variant is used on OpenHarmony OS (target_env = "ohos"
).
Xlib(XlibWindowHandle)
A raw window handle for Xlib.
§Availability Hints
This variant is likely to show up anywhere someone manages to get X11 working that Xlib can be built for, which is to say, most (but not all) Unix systems.
Xcb(XcbWindowHandle)
A raw window handle for Xcb.
§Availability Hints
This variant is likely to show up anywhere someone manages to get X11 working that XCB can be built for, which is to say, most (but not all) Unix systems.
Wayland(WaylandWindowHandle)
A raw window handle for Wayland.
§Availability Hints
This variant should be expected anywhere Wayland works, which is currently some subset of unix systems.
Drm(DrmWindowHandle)
A raw window handle for the Linux Kernel Mode Set/Direct Rendering Manager
§Availability Hints
This variant is used on Linux when neither X nor Wayland are available
Gbm(GbmWindowHandle)
A raw window handle for the Linux Generic Buffer Manager.
§Availability Hints
This variant is present regardless of windowing backend and likely to be used with EGL_MESA_platform_gbm or EGL_KHR_platform_gbm.
Win32(Win32WindowHandle)
WinRt(WinRtWindowHandle)
Web(WebWindowHandle)
A raw window handle for the Web.
§Availability Hints
This variant is used on Wasm or asm.js targets when targeting the Web/HTML5.
WebCanvas(WebCanvasWindowHandle)
A raw window handle for a Web canvas registered via wasm-bindgen
.
§Availability Hints
This variant is used on Wasm or asm.js targets when targeting the Web/HTML5.
WebOffscreenCanvas(WebOffscreenCanvasWindowHandle)
A raw window handle for a Web offscreen canvas registered via wasm-bindgen
.
§Availability Hints
This variant is used on Wasm or asm.js targets when targeting the Web/HTML5.
AndroidNdk(AndroidNdkWindowHandle)
Haiku(HaikuWindowHandle)
Trait Implementations§
source§impl AsRef<RawWindowHandle> for WindowHandle<'_>
impl AsRef<RawWindowHandle> for WindowHandle<'_>
source§fn as_ref(&self) -> &RawWindowHandle
fn as_ref(&self) -> &RawWindowHandle
source§impl Borrow<RawWindowHandle> for WindowHandle<'_>
impl Borrow<RawWindowHandle> for WindowHandle<'_>
source§fn borrow(&self) -> &RawWindowHandle
fn borrow(&self) -> &RawWindowHandle
source§impl Clone for RawWindowHandle
impl Clone for RawWindowHandle
source§fn clone(&self) -> RawWindowHandle
fn clone(&self) -> RawWindowHandle
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for RawWindowHandle
impl Debug for RawWindowHandle
source§impl From<AndroidNdkWindowHandle> for RawWindowHandle
impl From<AndroidNdkWindowHandle> for RawWindowHandle
source§fn from(value: AndroidNdkWindowHandle) -> Self
fn from(value: AndroidNdkWindowHandle) -> Self
source§impl From<AppKitWindowHandle> for RawWindowHandle
impl From<AppKitWindowHandle> for RawWindowHandle
source§fn from(value: AppKitWindowHandle) -> Self
fn from(value: AppKitWindowHandle) -> Self
source§impl From<DrmWindowHandle> for RawWindowHandle
impl From<DrmWindowHandle> for RawWindowHandle
source§fn from(value: DrmWindowHandle) -> Self
fn from(value: DrmWindowHandle) -> Self
source§impl From<GbmWindowHandle> for RawWindowHandle
impl From<GbmWindowHandle> for RawWindowHandle
source§fn from(value: GbmWindowHandle) -> Self
fn from(value: GbmWindowHandle) -> Self
source§impl From<HaikuWindowHandle> for RawWindowHandle
impl From<HaikuWindowHandle> for RawWindowHandle
source§fn from(value: HaikuWindowHandle) -> Self
fn from(value: HaikuWindowHandle) -> Self
source§impl From<OhosNdkWindowHandle> for RawWindowHandle
impl From<OhosNdkWindowHandle> for RawWindowHandle
source§fn from(value: OhosNdkWindowHandle) -> Self
fn from(value: OhosNdkWindowHandle) -> Self
source§impl From<OrbitalWindowHandle> for RawWindowHandle
impl From<OrbitalWindowHandle> for RawWindowHandle
source§fn from(value: OrbitalWindowHandle) -> Self
fn from(value: OrbitalWindowHandle) -> Self
source§impl From<UiKitWindowHandle> for RawWindowHandle
impl From<UiKitWindowHandle> for RawWindowHandle
source§fn from(value: UiKitWindowHandle) -> Self
fn from(value: UiKitWindowHandle) -> Self
source§impl From<WaylandWindowHandle> for RawWindowHandle
impl From<WaylandWindowHandle> for RawWindowHandle
source§fn from(value: WaylandWindowHandle) -> Self
fn from(value: WaylandWindowHandle) -> Self
source§impl From<WebCanvasWindowHandle> for RawWindowHandle
impl From<WebCanvasWindowHandle> for RawWindowHandle
source§fn from(value: WebCanvasWindowHandle) -> Self
fn from(value: WebCanvasWindowHandle) -> Self
source§impl From<WebOffscreenCanvasWindowHandle> for RawWindowHandle
impl From<WebOffscreenCanvasWindowHandle> for RawWindowHandle
source§fn from(value: WebOffscreenCanvasWindowHandle) -> Self
fn from(value: WebOffscreenCanvasWindowHandle) -> Self
source§impl From<WebWindowHandle> for RawWindowHandle
impl From<WebWindowHandle> for RawWindowHandle
source§fn from(value: WebWindowHandle) -> Self
fn from(value: WebWindowHandle) -> Self
source§impl From<Win32WindowHandle> for RawWindowHandle
impl From<Win32WindowHandle> for RawWindowHandle
source§fn from(value: Win32WindowHandle) -> Self
fn from(value: Win32WindowHandle) -> Self
source§impl From<WinRtWindowHandle> for RawWindowHandle
impl From<WinRtWindowHandle> for RawWindowHandle
source§fn from(value: WinRtWindowHandle) -> Self
fn from(value: WinRtWindowHandle) -> Self
source§impl From<WindowHandle<'_>> for RawWindowHandle
impl From<WindowHandle<'_>> for RawWindowHandle
source§fn from(handle: WindowHandle<'_>) -> Self
fn from(handle: WindowHandle<'_>) -> Self
source§impl From<XcbWindowHandle> for RawWindowHandle
impl From<XcbWindowHandle> for RawWindowHandle
source§fn from(value: XcbWindowHandle) -> Self
fn from(value: XcbWindowHandle) -> Self
source§impl From<XlibWindowHandle> for RawWindowHandle
impl From<XlibWindowHandle> for RawWindowHandle
source§fn from(value: XlibWindowHandle) -> Self
fn from(value: XlibWindowHandle) -> Self
source§impl Hash for RawWindowHandle
impl Hash for RawWindowHandle
source§impl PartialEq for RawWindowHandle
impl PartialEq for RawWindowHandle
source§fn eq(&self, other: &RawWindowHandle) -> bool
fn eq(&self, other: &RawWindowHandle) -> bool
self
and other
values to be equal, and is used
by ==
.