Trait ShellItem

Source

pub trait ShellItem {
    // Required methods
    fn get_display_name(&self, name: ShellItemDisplayName) -> Result<U16CString>;
    fn compare(&self, psi: &IShellItem, flags: u32) -> Result<Ordering>;
    fn get_attributes(&self, mask: ItemAttributes) -> Result<ItemAttributes>;

    // Provided methods
    fn from_path_w(path: PCWSTR) -> Result<IShellItem> { ... }
    fn from_id_list(id_list: &AbsoluteIDList) -> Result<IShellItem> { ... }
    fn is_folder(&self) -> bool { ... }
}

Expand description

IShellItem (shobjidl_core.h) - Win32 apps | Microsoft Learn

Required Methods§

Source

fn get_display_name(&self, name: ShellItemDisplayName) -> Result<U16CString>

IShellItem::GetDisplayName (shobjidl_core.h) - Win32 apps | Microsoft Learn

Source

fn compare(&self, psi: &IShellItem, flags: u32) -> Result<Ordering>

flags: SICHINTF_* (shobjidl_core.h)

Different from ShellFolder::compare_ids(), specifying the column doesn’t work. (Cleared by & 0xf0000000)

Internally, this usually calls ShellFolder::compare_ids().

IShellItem::Compare (shobjidl_core.h)

§Returns

Although the doc just says “If the two items are the same this parameter equals zero; if they are different the parameter is nonzero.” The sign actually defines the order like ShellFolder::compare_ids() does.

Source