Qt widget 焦点控制 查询状态、主动控制、响应事件 与 配置策略

我们来深入探讨一下 QWidget 的焦点处理机制。hasFocus() 只是冰山一角，Qt 提供了一整套强大而灵活的函数和机制来管理控件的焦点。

这套机制可以分为四个方面：查询状态、主动控制、响应事件 和 配置策略。

核心概念：什么是焦点 (Focus)？

在 GUI 应用程序中，“焦点”或“键盘焦点”指的是当前唯一能够接收键盘输入的界面控件。拥有焦点的控件通常会有一个视觉提示，比如闪烁的光标、高亮的边框等。用户按下键盘（如输入字符、按 Tab 键、按回车键）时，这些事件会直接发送给拥有焦点的控件。

1. 查询焦点状态 (Querying Focus State)

这是最基础的操作，用来判断一个控件的当前焦点状态。

bool hasFocus() const

• 功能：这是您已经了解的核心函数。它返回 true 如果该控件自身当前拥有键盘焦点，否则返回 false。
• 用途：用于条件判断。例如，“如果输入框A有焦点，那么按钮点击时就修改输入框A的内容”。

QWidget* QApplication::focusWidget() static

• 功能：这是一个非常重要的全局静态函数。它返回当前应用程序中拥有焦点的那个控件的指针。如果没有控件有焦点，则返回 nullptr。
• 用途：当您需要知道整个窗口中到底是哪个控件有焦点时使用，而不需要逐一去检查每个控件的 hasFocus()。

  // 检查当前拥有焦点的控件是否是一个 QLineEdit
  if (QLineEdit *le = qobject_cast<QLineEdit*>(QApplication::focusWidget())) {
      // 是的，现在是某个 QLineEdit 拥有焦点
      le->setText("Focus is here!");
  }
  

2. 主动控制焦点 (Actively Controlling Focus)

您可以不依赖用户操作，通过代码来主动设置或清除焦点。

void setFocus()

• 功能：请求将键盘焦点设置到该控件上。这是一个“槽” (slot)，可以很方便地连接到信号上。
• 注意：这只是一个 请求。如果控件因为某些原因不能接受焦点（例如它是隐藏的、被禁用的，或者它的焦点策略不允许），那么这个请求可能会失败。
• 用途：在窗口打开时，自动为某个输入框设置焦点；或者根据用户的某个操作，将焦点转移到指定的控件上。

  // 窗口显示后，让用户可以直接在 nameEdit 中输入
  MyDialog::MyDialog(QWidget *parent) : QDialog(parent) {
      ui->setupUi(this);
      ui->nameEdit->setFocus(); // 请求设置焦点
  }
  

void clearFocus()

• 功能：将焦点从该控件上移走。通常，焦点会根据焦点策略移动到“下一个”合适的控件上。
• 用途：在某些操作完成后，不希望任何输入框保持焦点状态，或者需要手动触发“失去焦点”的逻辑时使用。

3. 响应焦点事件 (Reacting to Focus Events)

这是焦点机制中最强大和常用的部分。通过重写事件处理函数，您可以在一个控件获得或失去焦点的那一刻执行自定义逻辑。

这两个函数都是 QWidget 的 protected virtual 函数，需要您在自己的子类中进行重写。

virtual void focusInEvent(QFocusEvent *event)

• 功能：当控件获得焦点时，这个函数会被自动调用。
• 用途：
  • 当用户点击输入框时，高亮其边框或改变背景色。
  • 当输入框获得焦点时，显示一个相关的提示信息。
  • 执行进入编辑状态前的准备工作。

virtual void focusOutEvent(QFocusEvent *event)

• 功能：当控件失去焦点时，这个函数会被自动调用。
• 用途：
  • 最常见的用途：进行数据验证。当用户输入完毕，将焦点移到下一个控件时，触发对当前输入内容的格式或有效性检查。
  • 取消 focusInEvent 设置的特殊外观（例如，恢复边框颜色）。
  • 执行离开编辑状态后的清理或保存工作。

示例：重写事件来实现高亮和验证

// MyLineEdit.h
#include <QLineEdit>
#include <QFocusEvent>

class MyLineEdit : public QLineEdit {
    Q_OBJECT
public:
    using QLineEdit::QLineEdit; // 继承构造函数

protected:
    void focusInEvent(QFocusEvent *event) override {
        this->setStyleSheet("background-color: lightyellow;"); // 获得焦点时变黄
        QLineEdit::focusInEvent(event); // 调用基类的实现
    }

    void focusOutEvent(QFocusEvent *event) override {
        this->setStyleSheet(""); // 失去焦点时恢复默认样式
        // 在这里可以添加验证逻辑
        if (this->text().isEmpty()) {
            qDebug() << "Warning: Input is empty!";
        }
        QLineEdit::focusOutEvent(event); // 调用基类的实现
    }
};

4. 配置焦点策略 (Configuring Focus Policy)

焦点策略决定了一个控件 如何以及是否可以接收焦点。

void setFocusPolicy(Qt::FocusPolicy policy)

• 功能：设置控件的焦点策略。
• Qt::FocusPolicy 是一个枚举，常用的值有：
  • Qt::NoFocus: 控件不能接收焦点。QLabel 默认就是这个策略。
  • Qt::TabFocus: 仅通过 Tab 键可以使控件获得焦点。
  • Qt::ClickFocus: 仅通过鼠标点击可以使控件获得焦点。
  • Qt::StrongFocus: 通过 Tab 键和鼠标点击都可以获得焦点。这是 QLineEdit, QPushButton 等交互类控件的默认策略。
  • Qt::WheelFocus: 在以上基础上，滚动鼠标滚轮也能让控件获得焦点（常用于滚动区域内的控件）。

Qt::FocusPolicy focusPolicy() const

• 功能：获取当前控件的焦点策略。

焦点链 (Focus Chain) 和 Tab 顺序

Qt 内部维护一个控件的“焦点链”，当用户按 Tab 键 (或 Shift+Tab) 时，焦点会沿着这个链向前（或向后）移动。

• QWidget::setTabOrder(QWidget *first, QWidget *second) (静态函数) :
  您可以显式地设置 Tab 键的顺序。调用 setTabOrder(a, b) 意味着当焦点在 a 上时，按 Tab 会将焦点移到 b。
• Qt Designer: 在 Qt Designer 中，您可以通过 编辑 -> 编辑Tab顺序 来可视化地设置 Tab 键的导航顺序，这是最方便的方式。

总结与对比

使用QSS :focus 伪状态的使用QSS :focus 伪状态的例子：

/* 在你的样式表中设置 */
QLineEdit:focus {
    border: 2px solid #4A90E2; /* 蓝色边框 */
    background-color: #F8F8F8; /* 浅灰色背景 */
}

这种方式通常比在 focusInEvent/focusOutEvent 中用 setStyleSheet 更好，因为它将逻辑和表现分离，且性能更高。