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.

The SelectedItem keeps the hidden helper window alive until it is dropped or consumed by execute, ensuring the owner HWND remains valid for commands that display UI (e.g., Properties dialog).

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.