Enum raw_window_handle::RawWindowHandle

source ·
#[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
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.
§

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)

A raw window handle for Win32.

§Availability Hints

This variant is used on Windows systems.

§

WinRt(WinRtWindowHandle)

A raw window handle for WinRT.

§Availability Hints

This variant is used on Windows systems.

§

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)

A raw window handle for Android NDK.

§Availability Hints

This variant is used on Android targets.

§

Haiku(HaikuWindowHandle)

A raw window handle for Haiku.

§Availability Hints

This variant is used on HaikuOS.

Trait Implementations§

source§

impl AsRef<RawWindowHandle> for WindowHandle<'_>

source§

fn as_ref(&self) -> &RawWindowHandle

Converts this type into a shared reference of the (usually inferred) input type.
source§

impl Borrow<RawWindowHandle> for WindowHandle<'_>

source§

fn borrow(&self) -> &RawWindowHandle

Immutably borrows from an owned value. Read more
source§

impl Clone for RawWindowHandle

source§

fn clone(&self) -> RawWindowHandle

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for RawWindowHandle

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl From<AndroidNdkWindowHandle> for RawWindowHandle

source§

fn from(value: AndroidNdkWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<AppKitWindowHandle> for RawWindowHandle

source§

fn from(value: AppKitWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<DrmWindowHandle> for RawWindowHandle

source§

fn from(value: DrmWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<GbmWindowHandle> for RawWindowHandle

source§

fn from(value: GbmWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<HaikuWindowHandle> for RawWindowHandle

source§

fn from(value: HaikuWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<OhosNdkWindowHandle> for RawWindowHandle

source§

fn from(value: OhosNdkWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<OrbitalWindowHandle> for RawWindowHandle

source§

fn from(value: OrbitalWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<UiKitWindowHandle> for RawWindowHandle

source§

fn from(value: UiKitWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<WaylandWindowHandle> for RawWindowHandle

source§

fn from(value: WaylandWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<WebCanvasWindowHandle> for RawWindowHandle

source§

fn from(value: WebCanvasWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<WebOffscreenCanvasWindowHandle> for RawWindowHandle

source§

fn from(value: WebOffscreenCanvasWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<WebWindowHandle> for RawWindowHandle

source§

fn from(value: WebWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<Win32WindowHandle> for RawWindowHandle

source§

fn from(value: Win32WindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<WinRtWindowHandle> for RawWindowHandle

source§

fn from(value: WinRtWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<WindowHandle<'_>> for RawWindowHandle

source§

fn from(handle: WindowHandle<'_>) -> Self

Converts to this type from the input type.
source§

impl From<XcbWindowHandle> for RawWindowHandle

source§

fn from(value: XcbWindowHandle) -> Self

Converts to this type from the input type.
source§

impl From<XlibWindowHandle> for RawWindowHandle

source§

fn from(value: XlibWindowHandle) -> Self

Converts to this type from the input type.
source§

impl Hash for RawWindowHandle

source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
source§

impl PartialEq for RawWindowHandle

source§

fn eq(&self, other: &RawWindowHandle) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Copy for RawWindowHandle

source§

impl Eq for RawWindowHandle

source§

impl StructuralPartialEq for RawWindowHandle

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.