WinForms自定义控件MouseDown事件传递至父控件的实现方案

问题原因 #

你遇到的System.StackOverflowException是因为无限递归：自定义控件自身订阅了MouseDown事件，在事件处理方法TestMouseDownControl_MouseDown中调用OnMouseDown(e)，而OnMouseDown方法会再次触发MouseDown事件，形成循环调用，最终耗尽栈空间导致异常。

正确实现方案 #

1. 基础实现：让父控件订阅自定义控件的MouseDown事件 #

移除自定义控件自身的MouseDown事件订阅，通过重写OnMouseDown方法来处理自身逻辑并触发事件，避免递归：

using System.Drawing;
using System.Windows.Forms;

namespace TestMouseDown
{
    public partial class TestMouseDownControl : Control
    {
        public TestMouseDownControl()
        {
            InitializeComponent();
        }

        // 重写OnMouseDown方法替代事件订阅
        protected override void OnMouseDown(MouseEventArgs e)
        {
            // 第一步：处理自定义控件自身逻辑
            BackColor = Color.LightSkyBlue; // 示例逻辑：点击时改变背景色

            // 第二步：调用基类方法，触发MouseDown事件（父控件订阅的事件会执行）
            base.OnMouseDown(e);
        }

        protected override void OnPaint(PaintEventArgs pe)
        {
            base.OnPaint(pe);
            Graphics g = pe.Graphics;
            g.FillRectangle(new SolidBrush(BackColor), ClientRectangle);
            g.DrawRectangle(Pens.Black, ClientRectangle);
        }
    }
}

父窗体代码保持原有订阅即可：

using System.Windows.Forms;

namespace TestMouseDown
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            TestMouseDownControl tmdc = new TestMouseDownControl();
            tmdc.Size = new Size(200, 100);
            tmdc.Location = new Point(50, 50);
            Controls.Add(tmdc);
            tmdc.MouseDown += Tmdc_MouseDown;
        }

        private void Tmdc_MouseDown(object sender, MouseEventArgs e)
        {
            MessageBox.Show("自定义控件MouseDown事件触发");
        }
    }
}

2. 进阶实现：将鼠标事件传递给父控件（触发父控件自身的MouseDown） #

如果需要让父控件像被直接点击一样触发自身的MouseDown事件，可以通过Windows API发送鼠标消息：

在自定义控件中添加以下代码（需要引入Interop服务）：

// 新增NativeMethods类用于调用Windows API
internal static class NativeMethods
{
    [System.Runtime.InteropServices.DllImport("user32.dll")]
    public static extern IntPtr SendMessage(IntPtr hWnd, int Msg, IntPtr wParam, IntPtr lParam);
}

// 修改OnMouseDown方法，添加消息发送逻辑
protected override void OnMouseDown(MouseEventArgs e)
{
    // 处理自身逻辑
    BackColor = Color.LightSkyBlue;

    // 触发自定义控件的MouseDown事件（供父控件订阅）
    base.OnMouseDown(e);

    // 发送鼠标消息给父控件，触发父控件的MouseDown
    if (Parent != null)
    {
        // 转换鼠标坐标为父控件坐标系
        Point parentPoint = PointToParent(e.Location);
        const int WM_LBUTTONDOWN = 0x0201; // 左键按下消息
        // 构造消息参数：wParam为鼠标按键，lParam为坐标（高16位Y，低16位X）
        IntPtr wParam = (IntPtr)e.Button;
        IntPtr lParam = (IntPtr)((parentPoint.Y << 16) | parentPoint.X);
        NativeMethods.SendMessage(Parent.Handle, WM_LBUTTONDOWN, wParam, lParam);
    }
}

此时父窗体自身的MouseDown事件也会被触发：

private void Form1_MouseDown(object sender, MouseEventArgs e)
{
    MessageBox.Show("窗体MouseDown事件触发");
}

核心要点 #

• 避免在控件自身订阅自身的事件后，在事件处理中调用触发事件的方法（如OnMouseDown），这会导致递归。
• WinForms中触发事件的标准方式是重写OnXXX方法，先处理自定义逻辑，再调用base.OnXXX(e)。
• 若需将事件“传递”给父控件（模拟父控件被点击），需通过Windows API发送原生鼠标消息，并注意坐标转换。

内容的提问来源于stack exchange，提问作者Bob Krauth