WinForm按Enter切换焦点时，TextBox的Leave事件（隐藏控件）引发焦点异常问题

我完全懂你这个痛点——本来想按Enter键按照自己设定的顺序在控件间切换焦点，结果因为Leave事件里隐藏了当前TextBox，焦点直接乱跑，完全不是预期的目标控件对吧？

问题根源 #

你在TextBox_KeyDown里手动切换了焦点，但紧接着触发的Leave事件中，你把当前TextBox设为不可见。这时候WinForm的焦点管理系统会认为“当前持有焦点的控件突然不可用了”，就会自动搜索下一个可用的可见控件来设置焦点，直接覆盖了你之前在KeyDown里做的焦点切换操作。

解决方案：延迟执行控件隐藏操作 #

核心思路是让焦点切换先完成，再处理控件的隐藏逻辑，避免Leave事件的同步操作干扰焦点系统。我们可以用BeginInvoke把隐藏操作放到UI消息队列的后面，等焦点已经稳定切换到目标控件后再执行。

1. 修改TextBox的Leave事件代码

把原来同步隐藏控件的逻辑，改成用BeginInvoke异步执行：

textBox.Leave += (s, e) =>
{
    // 用BeginInvoke延迟执行，确保焦点已经完成切换
    BeginInvoke(new Action(() =>
    {
        if (string.IsNullOrWhiteSpace(textBox.Text))
        {
            textBox.Text = "";
            textBoxHint.Visible = true;
            textBox.Visible = false;
        }
    }));
};

2. 优化KeyDown事件的焦点切换逻辑

另外，可以在TextBox_KeyDown里加上一点判断，确保焦点切换的目标控件确实能获得焦点，同时兼容HintTextBox的切换逻辑：

private void TextBox_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        e.SuppressKeyPress = true; // 阻止系统默认的Enter提示音
        TextBox textBox = sender as TextBox;
        if (textBox.Text.Trim() == "0")
        {
            textBox.Text = "";
        }

        Control senderControl = (Control)sender;
        Control parentControl = senderControl.Parent;
        int lastControlIndex = tlpDimensions.Controls.Count - 1;

        Control targetControl = null;
        if (tlpDimensions.Controls[lastControlIndex] == parentControl)
        {
            targetControl = txtMark;
        }
        else
        {
            // 尝试获取下一个控件
            targetControl = this.SelectNextControl(senderControl, true, true, true, true);
        }

        // 确保目标控件存在且可见，强制设置焦点
        if (targetControl != null && targetControl.Visible)
        {
            targetControl.Focus();
            // 如果目标是HintTextBox，手动触发它的切换逻辑
            if (targetControl.Tag.ToString().EndsWith("_Hint"))
            {
                TextBox hintBox = (TextBox)targetControl;
                Panel parentPanel = hintBox.Parent as Panel;
                TextBox actualTextBox = parentPanel.Controls.OfType<TextBox>()
                    .First(t => !t.Tag.ToString().EndsWith("_Hint"));
                actualTextBox.Text = hintBox.Text;
                actualTextBox.SelectAll();
                actualTextBox.Visible = true;
                hintBox.Visible = false;
                actualTextBox.Focus();
            }
        }
    }
}

3. 优化独立的TextBox_Leave事件

你代码里还有一个单独的TextBox_Leave方法用来后台计算提示框值，如果这个计算比较耗时，建议改成异步执行，避免阻塞UI线程导致焦点切换不顺畅：

private async void TextBox_Leave(object sender, EventArgs e)
{
    // 后台异步执行计算，不阻塞UI
    await Task.Run(() =>
    {
        // 你的重新计算逻辑
    });
    
    // 如果需要更新UI，记得切回主线程
    BeginInvoke(new Action(() =>
    {
        // 更新HintTextBox的逻辑
    }));
}

为什么这样有效？ #

BeginInvoke会把我们的隐藏操作放到UI消息队列的末尾，等当前的焦点切换操作（KeyDown里的Focus调用）完全处理完毕后，才会执行隐藏逻辑。这时候焦点已经牢牢锁定在目标控件上，WinForm的焦点系统不会再因为当前控件隐藏而重新分配焦点了。

备注：内容来源于stack exchange，提问作者Maxime Beaupré