Function init_com 

pub fn init_com() -> Result<ComGuard>

Initialize COM for the current thread in STA mode.

Returns a guard that calls CoUninitialize on drop. Keep it alive for the lifetime of your context-menu operations.

Errors

Returns Error::ComInit if COM has already been initialized with an incompatible threading model.

Example

let _com = win_context_menu::init_com()?;
// … use ContextMenu, ShellItems, etc. …

Examples found in repository

examples/enumerate.rs (line 4)

fn main() -> win_context_menu::Result<()> {
    let _com = init_com()?;

    let path = std::env::args()
        .nth(1)
        .unwrap_or_else(|| r"C:\Windows\notepad.exe".to_string());

    println!("Enumerating context menu items for: {}\n", path);

    let items = ShellItems::from_path(&path)?;
    let menu = ContextMenu::new(items)?;
    let entries = menu.enumerate()?;

    print_items(&entries, 0);

    Ok(())
}

examples/basic.rs (line 4)

fn main() -> win_context_menu::Result<()> {
    let _com = init_com()?;

    let path = std::env::args()
        .nth(1)
        .unwrap_or_else(|| r"C:\Windows\notepad.exe".to_string());

    println!("Showing context menu for: {}", path);

    let items = ShellItems::from_path(&path)?;
    let menu = ContextMenu::new(items)?;

    match menu.show()? {
        Some(selected) => {
            println!(
                "Selected: {} (verb: {:?})",
                selected.menu_item().label,
                selected.menu_item().command_string
            );
            selected.execute()?;
        }
        None => println!("No item selected."),
    }

    Ok(())
}

examples/folder_background.rs (line 4)

fn main() -> win_context_menu::Result<()> {
    let _com = init_com()?;

    let folder = std::env::args()
        .nth(1)
        .unwrap_or_else(|| r"C:\Windows".to_string());

    println!("Showing background context menu for folder: {}", folder);

    let items = ShellItems::folder_background(&folder)?;
    let menu = ContextMenu::new(items)?;

    match menu.show()? {
        Some(selected) => {
            println!(
                "Selected: {} (verb: {:?})",
                selected.menu_item().label,
                selected.menu_item().command_string
            );
            selected.execute()?;
        }
        None => println!("No item selected."),
    }

    Ok(())
}

examples/extended.rs (line 4)

fn main() -> win_context_menu::Result<()> {
    let _com = init_com()?;

    let path = std::env::args()
        .nth(1)
        .unwrap_or_else(|| r"C:\Windows\notepad.exe".to_string());

    println!("Showing extended context menu (Shift+right-click) for: {}", path);

    let items = ShellItems::from_path(&path)?;
    let menu = ContextMenu::new(items)?.extended(true);

    match menu.show()? {
        Some(selected) => {
            println!(
                "Selected: {} (verb: {:?})",
                selected.menu_item().label,
                selected.menu_item().command_string
            );
            selected.execute()?;
        }
        None => println!("No item selected."),
    }

    Ok(())
}

examples/multi_select.rs (line 4)

fn main() -> win_context_menu::Result<()> {
    let _com = init_com()?;

    let args: Vec<String> = std::env::args().skip(1).collect();
    let paths: Vec<String> = if args.is_empty() {
        vec![
            r"C:\Windows\notepad.exe".to_string(),
            r"C:\Windows\regedit.exe".to_string(),
        ]
    } else {
        args
    };

    println!("Showing context menu for {} items:", paths.len());
    for p in &paths {
        println!("  - {}", p);
    }

    let items = ShellItems::from_paths(&paths)?;
    let menu = ContextMenu::new(items)?;

    match menu.show()? {
        Some(selected) => {
            println!(
                "Selected: {} (verb: {:?})",
                selected.menu_item().label,
                selected.menu_item().command_string
            );
            selected.execute()?;
        }
        None => println!("No item selected."),
    }

    Ok(())
}