按下组合键时为UserControl内的TextBox子控件设置焦点问题

出现该问题的核心原因是跨层级设置控件焦点时，需要先保证父级容器（UserControl本身）先获得焦点，再给内部子控件设置焦点，同时推荐使用更稳定的快捷键处理方式避免事件被拦截。

步骤1：在UserControl中封装焦点设置方法 #

不要在Form中直接跨层级访问UserControl的内部控件，先在UserControl的代码中新增公共方法统一处理获焦逻辑：

// 以下代码写在你的UserControl类内部
public void FocusSearchTextBox()
{
    // 确保UserControl本身可用、可见
    if (!this.Visible || !this.Enabled)
        return;
    
    // 先给UserControl设置焦点
    this.Focus();
    // 替换下方的txtSearch为你实际的TextBox控件名称
    txtSearch.Focus();
    // 可选：自动选中TextBox内已有内容，方便用户直接输入
    txtSearch.SelectAll();
}

步骤2：在Form中实现稳定的快捷键监听 #

优先重写Form的ProcessCmdKey方法，该方法优先级高于KeyDown事件，不会因为当前焦点在其他控件上导致快捷键触发失效，不需要额外设置KeyPreview属性：

// 以下代码写在你的Form类内部
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
{
    // 匹配Ctrl+F组合键
    if (keyData == (Keys.Control | Keys.F))
    {
        // 替换userControl1为你窗体上实际的UserControl实例名
        userControl1.FocusSearchTextBox();
        // 返回true表示该快捷键已处理，不再向下传递
        return true;
    }
    return base.ProcessCmdKey(ref msg, keyData);
}

异常排查 #

如果按照上述步骤操作后仍无法正常获焦，检查以下配置：

• UserControl和内部TextBox的Enabled、Visible属性均为true，禁用/隐藏状态的控件无法接收焦点
• 若你坚持使用KeyDown事件实现，需确保Form的KeyPreview属性设置为true，且在事件处理逻辑中优先调用上述封装好的获焦方法
• 确认UserControl已被正确加载到Panel容器中，未被其他控件遮挡

内容的提问来源于stack exchange，提问作者Gamer In The Game