wcpopup  

Rust context menu for Windows and Linux(Gtk3).
Supports dark/light theme and color/size configuration.

• Colors
  • Text color
  • Background color
  • Border color
• Size
  • Menu padding
  • Menu item padding
• Font
  • Font family
  • Size and weight

Usage

Use ManuBuilder to create a Menu with MenuItems.

fn example(window_handle: isize) {
    let mut builder = MenuBuilder::new(window_handle);
    // Using HWND
    // let mut builder = MenuBuilder::new_for_hwnd(hwnd);
    // Using gtk::ApplicationWindow
    // let mut builder = MenuBuilder::new_for_window(window);

    builder.check("menu_item1", "Fit To Window", true, None);
    builder.separator();
    builder.text_with_accelerator("menu_item2", "Playlist", None, "Ctrl+P");
    builder.text_with_accelerator("menu_item3", "Toggle Fullscreen", None, "F11");
    builder.text("menu_item4", "Picture In Picture", None);
    builder.separator();
    builder.text_with_accelerator("menu_item5", "Capture", None, "Ctrl+S");
    builder.separator();

    let mut submenu = builder.submenu("submenu1", "Theme", None);
    submenu.radio("submenu_item1", "Light", "Theme", true, None);
    submenu.radio("submenu_item2", "Dark", "Theme", false, None);
    submenu.build().unwrap();

    let menu = builder.build().unwrap();

}

Call Menu.popup_at() to show Menu and receive the selected MenuItem using MenuEvent.

fn show_context_menu(x:i32, y:i32) {
    menu.popup_at(x, y);
}

if let Ok(event) = MenuEvent::receiver().try_recv() {
    let selected_menu_item = event.item;    
}

Or call Menu.popup_at_async() to show Menu and wait asynchronously for a selected MenuItem.

async fn show_context_menu(x:i32, y:i32) {
    let selected_menu_item = menu.popup_at(x, y).await;
}

Platform-specific notes

Windows

WebView2 may receive all keyboard input instead of its parent window(#1703).
Using WebView2, you may need to enable the feature flag.

--enable-features=msWebView2BrowserHitTransparent

Linux

Gtk3 is required.
MenuItem's text color is applied to SVG icon if the SVG file contains the "symbolic" term as the last component of the file name.

Accelerator

Accelerators are used only to display available shortcut keys by default.
Use "accelerator" feature to treat accelerators as commands.
With this feature, when a shortcut key is pressed, the corresponding MenuItem is returned as the result of Menu.popup_at().

features = ["accelerator"]