ContextMenuStrip（右键菜单）控件详解

本文面向零基础小白，所有代码都带详细注释。ContextMenuStrip 用于创建右键弹出的快捷菜单。

一、ContextMenuStrip 是什么

ContextMenuStrip（右键菜单，也叫快捷菜单）是在控件上点击右键时弹出的菜单，提供快捷操作。比如在列表上右键，弹出"删除""刷新"等选项。

基本信息

和 MenuStrip 的区别

二、如何创建 ContextMenuStrip

方式 1：设计器拖拽（推荐）

1. 从工具箱拖入 ContextMenuStrip（会出现在窗体下方）。
2. 点击它，编辑菜单项。
3. 把要关联的控件（如 ListView）的 ContextMenuStrip 属性设置成这个菜单。

方式 2：代码创建

// 创建右键菜单
ContextMenuStrip contextMenu = new ContextMenuStrip();

// 添加菜单项
contextMenu.Items.Add("删除");
contextMenu.Items.Add("刷新");
contextMenu.Items.Add("-");      // 分隔线
contextMenu.Items.Add("属性");

// 关联到某个控件（在控件上右键就弹出）
listView1.ContextMenuStrip = contextMenu;

三、ContextMenuStrip 的属性和菜单项

3.1 ContextMenuStrip 属性

Items —— 菜单项集合

contextMenuStrip1.Items.Add("删除");   // 添加菜单项

3.2 关联控件

// 方式1：给控件的 ContextMenuStrip 属性赋值
listView1.ContextMenuStrip = contextMenuStrip1;

// 方式2：给整个窗体设置右键菜单
this.ContextMenuStrip = contextMenuStrip1;

四、ContextMenuStrip 的事件

4.1 菜单项 Click 事件

// 菜单项"删除"的点击事件
private void menuDelete_Click(object sender, EventArgs e)
{
    MessageBox.Show("执行删除");
}

4.2 Opening —— 菜单弹出前（可动态改菜单）

什么时候触发：右键菜单弹出前触发，可以根据当前状态动态增删菜单项。

private void contextMenuStrip1_Opening(object sender, CancelEventArgs e)
{
    // 判断是否有选中项，没有就不显示"删除"
    menuDelete.Enabled = (listView1.SelectedItems.Count > 0);
}

五、实用技巧

5.1 给 ListView 加右键删除

// 右键菜单的"删除"点击事件
private void menuDelete_Click(object sender, EventArgs e)
{
    // 判断是否有选中项
    if (listView1.SelectedItems.Count > 0)
    {
        // 删除选中的项
        listView1.SelectedItems[0].Remove();
    }
    else
    {
        MessageBox.Show("请先选中要删除的项");
    }
}

5.2 动态添加菜单项

private void contextMenuStrip1_Opening(object sender, CancelEventArgs e)
{
    // 先清空旧的动态菜单项
    // （这里演示动态添加，实际项目要谨慎清空）

    // 动态添加一个菜单项
    contextMenuStrip1.Items.Add("动态菜单项");
}

六、数据绑定与实体类示例

ContextMenuStrip 常配合实体类，根据选中的对象动态生成菜单。这一节演示：右键点击 ListView 行，弹出针对该学生的操作菜单。

6.1 什么是实体类（Model）

// 定义"学生"实体类
public class Student
{
    public int Id { get; set; }          // 学号
    public string Name { get; set; }     // 姓名
}

6.2 右键菜单操作选中对象

public Form1()
{
    InitializeComponent();

    // 把右键菜单关联到 ListView
    listView1.ContextMenuStrip = contextMenuStrip1;
}

// 菜单项"查看详情"点击
private void menuView_Click(object sender, EventArgs e)
{
    // 判断是否有选中行
    if (listView1.SelectedItems.Count == 0)
    {
        MessageBox.Show("请先选中一个学生");
        return;
    }

    // 取出选中行关联的学生对象（Tag 里存的）
    Student student = (Student)listView1.SelectedItems[0].Tag;

    MessageBox.Show($"学生详情：\n学号：{student.Id}\n姓名：{student.Name}");
}

// 菜单项"删除"点击
private void menuDelete_Click(object sender, EventArgs e)
{
    if (listView1.SelectedItems.Count == 0)
    {
        MessageBox.Show("请先选中一个学生");
        return;
    }

    Student student = (Student)listView1.SelectedItems[0].Tag;

    // 确认删除
    DialogResult result = MessageBox.Show(
        $"确定删除 {student.Name} 吗？", "确认删除",
        MessageBoxButtons.YesNo, MessageBoxIcon.Warning);

    if (result == DialogResult.Yes)
    {
        // 删除选中行
        listView1.SelectedItems[0].Remove();
        MessageBox.Show("删除成功！");
    }
}

6.3 根据状态动态启用/禁用菜单项

private void contextMenuStrip1_Opening(object sender, CancelEventArgs e)
{
    // 有选中项时才启用"删除"和"查看"
    bool hasSelection = listView1.SelectedItems.Count > 0;
    menuView.Enabled = hasSelection;
    menuDelete.Enabled = hasSelection;
}

七、完整实战示例

做一个学生列表，右键弹出"查看详情/删除"菜单：

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();

        // 配置 ListView
        listView1.View = View.Details;
        listView1.FullRowSelect = true;
        listView1.Columns.Add("学号", 80);
        listView1.Columns.Add("姓名", 120);

        // 关联右键菜单
        listView1.ContextMenuStrip = contextMenuStrip1;
    }

    private void Form1_Load(object sender, EventArgs e)
    {
        // 准备数据
        List<Student> students = new List<Student>
        {
            new Student { Id = 1, Name = "张三" },
            new Student { Id = 2, Name = "李四" },
            new Student { Id = 3, Name = "王五" },
        };

        // 填充 ListView
        foreach (Student student in students)
        {
            ListViewItem item = new ListViewItem(student.Id.ToString());
            item.SubItems.Add(student.Name);
            item.Tag = student;   // 存对象
            listView1.Items.Add(item);
        }
    }

    // 右键菜单弹出前，根据选中状态启用/禁用菜单项
    private void contextMenuStrip1_Opening(object sender, CancelEventArgs e)
    {
        bool hasSelection = listView1.SelectedItems.Count > 0;
        menuView.Enabled = hasSelection;
        menuDelete.Enabled = hasSelection;
    }

    // 查看详情
    private void menuView_Click(object sender, EventArgs e)
    {
        Student student = (Student)listView1.SelectedItems[0].Tag;
        MessageBox.Show($"学号：{student.Id}，姓名：{student.Name}");
    }

    // 删除
    private void menuDelete_Click(object sender, EventArgs e)
    {
        Student student = (Student)listView1.SelectedItems[0].Tag;

        DialogResult result = MessageBox.Show($"确定删除 {student.Name} 吗？", "确认",
            MessageBoxButtons.YesNo, MessageBoxIcon.Warning);

        if (result == DialogResult.Yes)
        {
            listView1.SelectedItems[0].Remove();
        }
    }
}

// 学生实体类
public class Student
{
    public int Id { get; set; }
    public string Name { get; set; }
}

八、常见问题

Q1：右键菜单怎么不弹出来？
答：检查控件的 ContextMenuStrip 属性是否设置成了这个菜单。

Q2：怎么让菜单项根据状态动态启用/禁用？
答：在 Opening 事件里设置菜单项的 Enabled。

Q3：怎么给整个窗体加右键菜单？
答：this.ContextMenuStrip = contextMenuStrip1;

Q4：怎么加分隔线？
答：菜单项文字设为 "-"。

Q5：怎么在菜单项里操作选中的对象？
答：用 Tag 存对象，菜单点击事件里 (类型)xxx.Tag 取回。