Struct SelectedItem 

pub struct SelectedItem { /* private fields */ }

A menu item that was selected by the user via ContextMenu::show or ContextMenu::show_at.

Call execute to run the associated shell command, or inspect menu_item to decide first.

Implementations

impl SelectedItem

pub fn menu_item(&self) -> &MenuItem

Get the menu item metadata (label, verb, flags, etc.).

Examples found in repository

examples/basic.rs (line 19)

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 19)

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 19)

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 28)

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(())
}

pub fn command_id(&self) -> u32

Get the raw command ID that was returned by TrackPopupMenu.

pub fn execute(self) -> Result<()>

Execute the selected command with default parameters.

This is equivalent to the user clicking the menu item in Explorer. Consumes self because a command can only be invoked once.

Examples found in repository

examples/basic.rs (line 22)

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 22)

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 22)

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 31)

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(())
}

pub fn execute_with(self, params: InvokeParams) -> Result<()>

Execute the selected command with custom parameters.

Use this to override the working directory or window show state.

Trait Implementations

impl Debug for SelectedItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.