Struct cacao::utils::properties::ObjcProperty

pub struct ObjcProperty(_);

A wrapper for single-threaded ObjcProperty types.

An ObjcProperty is something that exists on the Objective-C side that we want to interact with, and support cloning with respect to our side and the general Rust rules. Thus, we do a layer of Rc/RefCell to shield things and make life easier.

It is possible we could remove the Id wrapper in here if we’re just doing this ourselves, and is probably worth investigating at some point.

Implementations

impl ObjcProperty

pub fn retain(obj: id) -> Self

Given an Objective-C object, retains it and wraps it as a Property.

pub fn from_retained(obj: id) -> Self

Given an Objective-C object, retains it and wraps it as a Property.

pub fn with_mut<F: Fn(id)>(&self, handler: F)

Runs a handler with mutable access for the underlying Objective-C object.

Note that this is mutable access from the Rust side; we make every effort to ensure things are valid on the Objective-C side as well, but there be dragons.

pub fn get<R, F: Fn(&Object) -> R>(&self, handler: F) -> R

Runs a handler with the underlying Objective-C type.

The handler can return whatever; this is primarily intended for dynamically calling getters on the underlying type.

Trait Implementations

impl Clone for ObjcProperty

fn clone(&self) -> ObjcProperty

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ObjcProperty

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

Formats the value using the given formatter.