C# WinForm PictureBox矩阵鼠标按下拖拽标记失效问题

• WinForm原生鼠标捕获机制拦截事件：当鼠标在单个PictureBox控件上按下时，该控件会自动开启鼠标捕获，独占所有鼠标输入消息。此时拖拽鼠标经过其他PictureBox时，被经过的控件无法触发MouseEnter事件，写在MouseEnter里的颜色判断逻辑根本不会执行。
• 代码存在笔误隐患：初始化控件时你赋值的数组是m_VisualizerPictureBox，但后续绑定事件、修改颜色时用的数组名是m_VisualizerRectangles，如果两个不是同一个数组实例，事件会绑定到空对象或者错误对象上，直接导致逻辑失效。
• 交互逻辑存在漏洞：
  1. 鼠标按下时没有处理当前所在格子的颜色，第一个按下的格子不会立刻变色
  2. MouseUp事件只绑定在单个格子上，如果鼠标拖到窗体空白处、窗体外松开，m_MouseIsDown状态不会被重置，后续会出现无按下也触发标记的bug
  3. 拖拽过程中反复进出同一个格子会来回切换颜色，不符合拖拽时连续标记/擦除的预期

1. 统一控件数组引用 #

全局统一使用同一个控件数组存储格子实例，不要混用m_VisualizerPictureBox和m_VisualizerRectangles两个数组名，避免事件绑定、控件操作指向错误对象。

2. 新增全局状态字段 #

在窗体类中新增两个状态字段，记录鼠标按下状态和本次拖拽的操作模式，避免拖拽过程中颜色反复横跳：

// 标记鼠标是否处于按下拖拽状态
private bool m_MouseIsDown = false;
// 标记本次拖拽是绘制障碍还是擦除障碍：true为画黑，false为擦除回默认色
private bool m_IsDrawAction = false;

3. 简化格子事件绑定 #

在initBoard方法中，移除原来每个格子绑定的Click、MouseUp、MouseEnter事件，仅保留MouseDown事件，在按下瞬间确定操作模式并修改当前格子颜色，覆盖点击标记的交互需求：

// 替换原来的事件绑定代码
m_VisualizerPictureBox[i, j].MouseDown += (sender, e) =>
{
    m_MouseIsDown = true;
    var currentBox = sender as UpgradedPictureBox;
    // 按下瞬间确定本次拖拽的操作类型，和点击效果保持一致
    m_IsDrawAction = currentBox.BackColor == currentBox.m_DefaultBackColor;
    currentBox.BackColor = m_IsDrawAction ? Color.Black : currentBox.m_DefaultBackColor;
};

4. 绑定窗体级全局鼠标事件 #

在窗体构造函数中绑定窗体级别的鼠标事件，绕开单个控件的鼠标捕获限制，统一处理拖拽过程的标记逻辑和状态重置：

// 放在InitializeComponent()之后即可
// 全局监听鼠标抬起，重置状态
this.MouseUp += (_, _) => { m_MouseIsDown = false; };
// 鼠标离开窗体区域直接重置状态，避免拖出窗外松开导致状态错乱
this.MouseLeave += (_, _) => { m_MouseIsDown = false; };
// 全局监听鼠标移动，处理拖拽标记
this.MouseMove += OnGlobalMouseMove;

实现全局鼠标移动处理方法，直接根据鼠标实时坐标命中对应格子修改颜色：

private void OnGlobalMouseMove(object sender, MouseEventArgs e)
{
    if (!m_MouseIsDown) return;
    // 获取鼠标在窗体客户区的实时坐标
    Point cursorPos = this.PointToClient(Cursor.Position);
    // 找到坐标位置对应的子控件
    Control hitControl = this.GetChildAtPoint(cursorPos);
    // 如果命中的是自定义格子控件，直接按预设的操作模式修改颜色
    if (hitControl is UpgradedPictureBox targetBox)
    {
        targetBox.BackColor = m_IsDrawAction ? Color.Black : targetBox.m_DefaultBackColor;
    }
}

方案说明 #

改造后所有鼠标状态判断、位置计算都由窗体统一处理，不再依赖单个格子的MouseEnter事件，完全绕开了控件独占鼠标消息的限制，拖拽过程中只要鼠标经过格子就会按拖拽开始时设定的模式统一修改颜色，不会出现反复切换、无法触发的问题，同时兼容点击标记、拖拽连续标记两种交互。

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