Trait winsafe::prelude::shell_IShellItem

pub trait shell_IShellItem: ole_IUnknown {
    // Provided methods
    fn BindToHandler<T>(
        &self,
        bind_ctx: Option<&impl ole_IBindCtx>,
        bhid: &BHID
    ) -> HrResult<T>
       where T: ole_IUnknown { ... }
    fn Compare(
        &self,
        other: &impl shell_IShellItem,
        hint: SICHINTF
    ) -> HrResult<i32> { ... }
    fn GetAttributes(&self, sfgao_mask: SFGAO) -> HrResult<SFGAO> { ... }
    fn GetDisplayName(&self, sigdn_name: SIGDN) -> HrResult<String> { ... }
    fn GetParent(&self) -> HrResult<IShellItem> { ... }
}

Available on crate features kernel and shell only.

This trait is enabled with the shell feature, and provides methods for IShellItem.

Prefer importing this trait through the prelude:

use winsafe::prelude::*;

Provided Methods

fn BindToHandler<T>( &self, bind_ctx: Option<&impl ole_IBindCtx>, bhid: &BHID ) -> HrResult<T>

where T: ole_IUnknown,

IShellItem::BindToHandler method.

Examples

Retrieving the items inside a directory:

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

let sh_folder: w::IShellItem; // initialized somewhere

let sh_items = sh_folder.BindToHandler::<w::IEnumShellItems>(
    None::<&w::IBindCtx>,
    &co::BHID::EnumItems,
)?;

fn Compare( &self, other: &impl shell_IShellItem, hint: SICHINTF ) -> HrResult<i32>

IShellItem::Compare method.

fn GetAttributes(&self, sfgao_mask: SFGAO) -> HrResult<SFGAO>

IShellItem::GetAttributes method.

fn GetDisplayName(&self, sigdn_name: SIGDN) -> HrResult<String>

IShellItem::GetDisplayName method.

Examples

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

let shi = w::SHCreateItemFromParsingName::<w::IShellItem>(
    "C:\\Temp\\foo.txt",
    None::<&w::IBindCtx>,
)?;

let full_path = shi.GetDisplayName(co::SIGDN::FILESYSPATH)?;

println!("{}", full_path);

fn GetParent(&self) -> HrResult<IShellItem>

IShellItem::GetParent method.

Examples

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

let shi = w::SHCreateItemFromParsingName::<w::IShellItem>(
    "C:\\Temp\\foo.txt",
    None::<&w::IBindCtx>,
)?;

let parent_shi = shi.GetParent()?;
let full_path = parent_shi.GetDisplayName(co::SIGDN::FILESYSPATH)?;

println!("{}", full_path);

Object Safety

This trait is not object safe.

Implementors

impl shell_IShellItem for IShellItem2

impl shell_IShellItem for IShellItem