ContextMenuStrip帮助类（只有一级菜单）

帮助类代码

using System;
using System.Collections.Generic;
using System.Windows.Forms;

namespace YourNamespace.Utilities
{
    /// <summary>
    /// ContextMenuStrip 帮助类，用于简化右键菜单的创建和管理。
    /// </summary>
    public static class ContextMenuHelper
    {
        /// <summary>
        /// 创建一个新的 ContextMenuStrip 并添加菜单项。
        /// </summary>
        /// <param name="menuItems">菜单项文本和其点击事件的键值对。</param>
        /// <param name="withSeparator">是否在每个菜单项后添加分隔线（最后一个除外）。</param>
        /// <returns>配置好的 ContextMenuStrip。</returns>
        public static ContextMenuStrip Create(Dictionary<string, EventHandler> menuItems, bool withSeparator = false)
        {
            ContextMenuStrip menu = new ContextMenuStrip();

            foreach (var item in menuItems)
            {
                ToolStripMenuItem menuItem = new ToolStripMenuItem(item.Key);
                menuItem.Click += item.Value;
                menu.Items.Add(menuItem);

                if (withSeparator && menuItems.Last().Key != item.Key)
                {
                    menu.Items.Add(new ToolStripSeparator());
                }
            }
            return menu;
        }

        /// <summary>
        /// 将指定的 ContextMenuStrip 动态绑定到控件的 MouseDown 事件上，以响应右键点击。
        /// </summary>
        /// <param name="control">目标控件。</param>
        /// <param name="menu">要绑定的 ContextMenuStrip。</param>
        public static void BindToControlMouseDown(Control control, ContextMenuStrip menu)
        {
            control.MouseDown += (sender, e) =>
            {
                if (e.Button == MouseButtons.Right)
                {
                    menu.Show(control, e.Location);
                }
            };
        }

        /// <summary>
        /// 在现有菜单的指定索引位置插入一个新的菜单项。
        /// </summary>
        /// <param name="menu">目标菜单。</param>
        /// <param name="index">插入位置的索引。</param>
        /// <param name="text">新菜单项的文本。</param>
        /// <param name="clickHandler">点击事件处理程序。</param>
        public static void InsertMenuItem(ContextMenuStrip menu, int index, string text, EventHandler clickHandler)
        {
            ToolStripMenuItem newItem = new ToolStripMenuItem(text);
            newItem.Click += clickHandler;
            menu.Items.Insert(index, newItem);
        }

        /// <summary>
        /// 根据名称查找菜单中的 ToolStripMenuItem。
        /// </summary>
        /// <param name="menu">目标菜单。</param>
        /// <param name="itemName">要查找的菜单项名称（ToolStripItem.Name）。</param>
        /// <returns>找到的菜单项，未找到则返回null。</returns>
        public static ToolStripMenuItem FindMenuItemByName(ContextMenuStrip menu, string itemName)
        {
            foreach (ToolStripItem item in menu.Items)
            {
                if (item is ToolStripMenuItem menuItem && menuItem.Name == itemName)
                {
                    return menuItem;
                }
            }
            return null;
        }

        /// <summary>
        /// 根据菜单项文本动态启用或禁用菜单项。通常在菜单 Opening 事件中调用[citation:3]。
        /// </summary>
        /// <param name="menu">目标菜单。</param>
        /// <param name="itemText">菜单项文本。</param>
        /// <param name="enabled">启用状态。</param>
        public static void SetMenuItemEnabledByText(ContextMenuStrip menu, string itemText, bool enabled)
        {
            foreach (ToolStripItem item in menu.Items)
            {
                if (item.Text == itemText)
                {
                    item.Enabled = enabled;
                    break;
                }
            }
        }
    }
}

帮助类功能与使用场景说明

这个帮助类主要解决了以下几个常见场景的痛点：

 

功能模块	主要方法	解决的问题/适用场景
快速创建	Create	避免重复编写创建菜单项、绑定事件的代码，一键生成基础菜单。
动态绑定	BindToControlMouseDown	对于没有内置ContextMenuStrip属性的控件或需要更灵活触发条件的场景（如特定区域右键）。
动态管理	InsertMenuItem, FindMenuItemByName	在运行时根据程序状态动态增删或查找菜单项。
状态控制	SetMenuItemEnabledByText	根据上下文（如是否有选中项）动态启用/禁用某些菜单项，提升用户体验。

 

完整使用示例：DataGridView右键菜单

以下示例演示了如何在DataGridView上使用帮助类实现一个具有复制、粘贴和动态删除功能的右键菜单。

public partial class MainForm : Form
{
    private ContextMenuStrip dataGridViewMenu;

    public MainForm()
    {
        InitializeComponent();
        SetupContextMenu();
    }

    private void SetupContextMenu()
    {
        // 1. 使用帮助类创建菜单
        var menuItems = new Dictionary<string, EventHandler>
        {
            { "复制", MenuItem_Copy_Click },
            { "粘贴", MenuItem_Paste_Click },
            { "删除", MenuItem_Delete_Click }
        };
        dataGridViewMenu = ContextMenuHelper.Create(menuItems, withSeparator: true);

        // 2. 绑定到DataGridView的MouseDown事件，实现右键触发
        ContextMenuHelper.BindToControlMouseDown(dataGridView1, dataGridViewMenu);

        // 3. （可选）在菜单打开前动态设置“删除”项是否可用
        dataGridViewMenu.Opening += (sender, e) =>
        {
            // 仅当有选中行时，“删除”项才可用
            ContextMenuHelper.SetMenuItemEnabledByText(dataGridViewMenu, "删除", dataGridView1.SelectedRows.Count > 0);
        };
    }

    // 菜单项点击事件处理程序
    private void MenuItem_Copy_Click(object sender, EventArgs e)
    {
        // 实现复制逻辑...
        MessageBox.Show("执行复制");
    }

    private void MenuItem_Paste_Click(object sender, EventArgs e)
    {
        // 实现粘贴逻辑...
        MessageBox.Show("执行粘贴");
    }

    private void MenuItem_Delete_Click(object sender, EventArgs e)
    {
        // 实现删除选中行逻辑...
        if (dataGridView1.SelectedRows.Count > 0)
        {
            dataGridView1.Rows.RemoveAt(dataGridView1.SelectedRows[0].Index);
        }
    }
}

总的来说，ContextMenuHelper 帮助类通过封装常见操作，可以减少你的重复代码，让你更专注于业务逻辑的实现。