Struct winsafe::IFileDialogEvents

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

Available on crate feature shell only.

IFileDialogEvents COM interface over IFileDialogEventsVT.

Automatically calls IUnknown::Release when the object goes out of scope.

Examples

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

let hparent: w::HWND; // initialized somewhere

let file_open = w::CoCreateInstance::<w::IFileOpenDialog>(
    &co::CLSID::FileOpenDialog,
    None,
    co::CLSCTX::INPROC_SERVER,
)?;

let file_dialog_events = w::IFileDialogEvents::new_impl();

file_dialog_events.OnFolderChanging(
    move |fd: &w::IFileDialog, si: &w::IShellItem| -> w::HrResult<()> {
        println!("New folder: {}",
            si.GetDisplayName(co::SIGDN::FILESYSPATH)?);
        Ok(())
    },
);

file_open.Advise(&file_dialog_events)?;

Implementations

impl IFileDialogEvents

pub fn new_impl() -> Self

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

impl IFileDialogEvents

pub fn OnFileOk<F>(&self, func: F)

where F: Fn(&IFileDialog) -> HrResult<()> + 'static,

IFileDialogEvents::OnFileOk method.

pub fn OnFolderChange<F>(&self, func: F)

where F: Fn(&IFileDialog) -> HrResult<()> + 'static,

IFileDialogEvents::OnFolderChange method.

pub fn OnFolderChanging<F>(&self, func: F)

where F: Fn(&IFileDialog, &IShellItem) -> HrResult<()> + 'static,

IFileDialogEvents::OnFolderChanging method.

pub fn OnOverwrite<F>(&self, func: F)

where F: Fn(&IFileDialog, &IShellItem) -> HrResult<FDEOR> + 'static,

IFileDialogEvents::OnOverwrite method.

pub fn OnSelectionChange<F>(&self, func: F)

where F: Fn(&IFileDialog) -> HrResult<()> + 'static,

IFileDialogEvents::OnSelectionChange method.

pub fn OnShareViolation<F>(&self, func: F)

where F: Fn(&IFileDialog, &IShellItem) -> HrResult<FDESVR> + 'static,

IFileDialogEvents::OnShareViolation method.

pub fn OnTypeChange<F>(&self, func: F)

where F: Fn(&IFileDialog) -> HrResult<()> + 'static,

IFileDialogEvents::OnTypeChange method.

Trait Implementations

impl Clone for IFileDialogEvents

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Drop for IFileDialogEvents

fn drop(&mut self)

Executes the destructor for this type.

impl ole_IUnknown for IFileDialogEvents

const IID: IID = _

Available on crate feature ole only.

The COM interface ID.

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

Available on crate feature ole only.

Creates an object from a COM virtual table pointer.

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

Available on crate feature ole only.

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

fn ptr(&self) -> *mut c_void

Available on crate feature ole only.

Returns the pointer to the underlying COM virtual table.

unsafe fn null() -> Self

Available on crate feature ole only.

Creates an object from a null COM virtual table pointer.

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

Available on crate feature ole only.

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,

Available on crate feature ole only.

IUnknown::QueryInterface method.

impl Send for IFileDialogEvents