Struct intercom::ComBox

pub struct ComBox<T: ComClass> { /* private fields */ }

Pointer to a COM-enabled Rust struct.

Intercom requires a specific memory layout for the COM objects so that it can implement reference counting and map COM method calls back to the target struct instance.

This is done by requiring each COM-enabled Rust object is constructed through a ComBox<T> type.

Technically the memory layout is specified by the ComBoxData type, however that type shouldn’t be needed by the user. For all intents the ComBox type is the COM-compatible object handle.

Implementations

impl<T: ComClass> ComBox<T>

pub fn new(value: T) -> ComBox<T>

Constructs a new ComBox by placing the value into reference counted memory.

• value - The initial state to use for the COM object.

Trait Implementations

impl<T: ComClass> AsMut<ComBoxData<T>> for ComBox<T>

fn as_mut(&mut self) -> &mut ComBoxData<T>

Converts this type into a mutable reference of the (usually inferred) input type.

impl<T: ComClass> AsRef<ComBoxData<T>> for ComBox<T>

fn as_ref(&self) -> &ComBoxData<T>

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

impl<T: ComClass + Debug> Debug for ComBox<T>

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

Formats the value using the given formatter.

impl<T: Default + ComClass> Default for ComBox<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T> Deref for ComBox<T> where
    T: ComClass, 

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T> DerefMut for ComBox<T> where
    T: ComClass, 

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

Mutably dereferences the value.

impl<T: ComClass> Drop for ComBox<T>

fn drop(&mut self)

Decreases the reference count by one. If this is the last reference the memory will be deallocated.

impl<I: ComInterface + ?Sized, T: HasInterface<I>> From<&ComBox<T>> for ComRc<I>

fn from(combox: &ComBox<T>) -> Self

Converts to this type from the input type.

impl<I: ComInterface + ?Sized, T: HasInterface<I>> From<ComBox<T>> for ComRc<I>

fn from(source: ComBox<T>) -> ComRc<I>

Converts to this type from the input type.

impl<T: HasInterface<dyn IUnknown>> From<ComBox<T>> for Variant

fn from(src: ComBox<T>) -> Self

Converts to this type from the input type.