Struct raw_window_handle::AppKitWindowHandle

source ·
#[non_exhaustive]
pub struct AppKitWindowHandle { pub ns_view: NonNull<c_void>, }
Expand description

Raw window handle for AppKit.

Note that NSView can only be accessed from the main thread of the application. This struct is !Send and !Sync to help with ensuring that.

§Example

Getting the view from a WindowHandle.

#![cfg(target_os = "macos")]
use objc2_app_kit::NSView;
use objc2_foundation::is_main_thread;
use objc2::rc::Id;
use raw_window_handle::{WindowHandle, RawWindowHandle};

let handle: WindowHandle<'_>; // Get the window handle from somewhere else
match handle.as_raw() {
    RawWindowHandle::AppKit(handle) => {
        assert!(is_main_thread(), "can only access AppKit handles on the main thread");
        let ns_view = handle.ns_view.as_ptr();
        // SAFETY: The pointer came from `WindowHandle`, which ensures
        // that the `AppKitWindowHandle` contains a valid pointer to an
        // `NSView`.
        // Unwrap is fine, since the pointer came from `NonNull`.
        let ns_view: Id<NSView> = unsafe { Id::retain(ns_view.cast()) }.unwrap();
        // Do something with the NSView here, like getting the `NSWindow`
        let ns_window = ns_view.window().expect("view was not installed in a window");
    }
    handle => unreachable!("unknown handle {handle:?} for platform"),
}

Fields (Non-exhaustive)§

This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.
§ns_view: NonNull<c_void>

A pointer to an NSView object.

Implementations§

source§

impl AppKitWindowHandle

source

pub fn new(ns_view: NonNull<c_void>) -> Self

Create a new handle to a view.

§Example
let view: &NSView;
let handle = AppKitWindowHandle::new(NonNull::from(view).cast());

Trait Implementations§

source§

impl Clone for AppKitWindowHandle

source§

fn clone(&self) -> AppKitWindowHandle

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 AppKitWindowHandle

source§

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

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

impl From<AppKitWindowHandle> for RawWindowHandle

source§

fn from(value: AppKitWindowHandle) -> Self

Converts to this type from the input type.
source§

impl Hash for AppKitWindowHandle

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 AppKitWindowHandle

source§

fn eq(&self, other: &AppKitWindowHandle) -> 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 AppKitWindowHandle

source§

impl Eq for AppKitWindowHandle

source§

impl StructuralPartialEq for AppKitWindowHandle

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.