Struct IDropTarget 

pub struct IDropTarget(/* private fields */);

Available on crate feature ole only.

IDropTarget COM interface.

Automatically calls Release when the object goes out of scope.

Examples

Retrieving dropped files:

use winsafe::{self as w, prelude::*, co};

let drop_target = w::IDropTarget::new_impl();

drop_target.Drop(
    |d: &w::IDataObject, key_st: co::MK, pt: w::POINT, fx: &mut co::DROPEFFECT|
        -> w::AnyResult<()>
    {
        let mut fmt = w::FORMATETC::default();
        fmt.cfFormat = co::CF::HDROP;
        fmt.dwAspect = co::DVASPECT::CONTENT;
        fmt.tymed = co::TYMED::HGLOBAL;

        let medium = unsafe { d.GetData(&fmt)? };
        let hglobal = unsafe { medium.ptr_hglobal().unwrap() };
        let ptr_lock = hglobal.GlobalLock()?;
        let hdrop = unsafe { w::HDROP::from_ptr(ptr_lock.as_ptr() as _) };
        let dropped_paths = hdrop.DragQueryFile()?
            .collect::<w::SysResult<Vec<_>>>()?;

        for f in dropped_paths {
            println!("> {f}");
        }

        Ok(())
    },
);

Implementations

impl IDropTarget

pub fn new_impl() -> Self

Creates a custom COM implementation, to which you can add closures to handle events.

impl IDropTarget

pub fn DragEnter<F>(&self, func: F) -> &Self

where F: Fn(&IDataObject, MK, POINT, &mut DROPEFFECT) -> AnyResult<()> + 'static,

IDropTarget::DragEnter method.

Examples

use winsafe::{self as w, prelude::*, co};

let drop_target = w::IDropTarget::new_impl();

drop_target.DragEnter(
    |d: &w::IDataObject, key_st: co::MK, pt: w::POINT, fx: &mut co::DROPEFFECT|
        -> w::AnyResult<()>
    {
        *fx &= co::DROPEFFECT::COPY;
        Ok(())
    },
);

pub fn DragLeave<F>(&self, func: F) -> &Self

where F: Fn() -> AnyResult<()> + 'static,

IDropTarget::DragLeave method.

pub fn DragOver<F>(&self, func: F) -> &Self

where F: Fn(MK, POINT, &mut DROPEFFECT) -> AnyResult<()> + 'static,

IDropTarget::DragOver method.

Examples

use winsafe::{self as w, prelude::*, co};

let drop_target = w::IDropTarget::new_impl();

drop_target.DragOver(
    |key_st: co::MK, pt: w::POINT, fx: &mut co::DROPEFFECT|
        -> w::AnyResult<()>
    {
        *fx &= co::DROPEFFECT::COPY;
        Ok(())
    },
);

pub fn Drop<F>(&self, func: F) -> &Self

where F: Fn(&IDataObject, MK, POINT, &mut DROPEFFECT) -> AnyResult<()> + 'static,

IDropTarget::Drop method.

Trait Implementations

impl Clone for IDropTarget

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for IDropTarget

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Send for IDropTarget

impl ole_IUnknown for IDropTarget

const IID: IID

The COM interface ID.

unsafe fn from_ptr(_p: *mut c_void) -> Self

Creates an object from a COM virtual table pointer.

unsafe fn as_mut(&mut self) -> &mut *mut c_void

Returns a mutable reference do the underlying COM virtual table pointer.

fn ptr(&self) -> *mut c_void

Returns the pointer to the underlying COM virtual table.

unsafe fn null() -> Self

Creates an object from a null COM virtual table pointer.

fn leak(&mut self) -> *mut c_void

Returns the pointer to the underlying COM virtual table and sets the internal pointer to null, so that Release won’t be called.

fn QueryInterface<T>(&self) -> HrResult<T>

where T: ole_IUnknown,

IUnknown::QueryInterface method.