Qt 常见问题

cpp for (auto *btn : buttonList) { connect(btn, &QPushButton::clicked, this, btn { qDebug() << "Button" << btn->text() << "clicked"; }); }

这样无需关心信号来源的准确区分，更灵活。

## 界面与布局

### 控件大小和位置不随窗口缩放

务必使用布局管理器（`QHBoxLayout`, `QVBoxLayout`, `QGridLayout`）而非绝对定位。在 Qt Designer 中，选中控件后点击工具栏上的布局按钮（如水平布局），或右键选择“布局”->“水平布局”。在代码中：

```cpp
auto *layout = new QVBoxLayout(this);
layout->addWidget(myButton);
layout->addWidget(myLabel);
setLayout(layout);

如果效果仍不理想，检查 sizePolicy 属性，调整水平和垂直策略为 Expanding 或 Preferred。

如何让控件按比例分配空间？

利用 QBoxLayout::addWidget 的拉伸因子：

layout->addWidget(leftWidget, 1);   // 占 1 份
layout->addWidget(rightWidget, 2);  // 占 2 份，总空间3份，右侧占2/3

在 Designer 中，可在控件属性里设置 stretch。

子控件太多导致界面卡顿？优雅的分页与延迟加载

• QStackedWidget：配合 QListWidget 或 Tree 实现分页，仅当前页面控件被显示。
• QScrollArea + 懒加载：对于大量相似项，使用 QScrollArea 配合自定义 widget，只创建可见区域内的子控件，并回收移出视野的控件，类似于手机列表优化。
• 模型/视图框架：QListView / QTreeView + QAbstractItemModel 处理大数据高效、内存占用低。可配合委托自定义绘制。

线程与异步

工作线程如何安全地更新 UI？

唯一规则：UI 操作必须在主线程。工作线程通过信号将数据发送给 UI 线程。工作对象可移至 QThread：

QThread *thread = new QThread;
Worker *worker = new Worker;
worker->moveToThread(thread);
connect(worker, &Worker::resultReady, this, &MainWindow::handleResults);
connect(thread, &QThread::finished, worker, &QObject::deleteLater);
connect(thread, &QThread::started, worker, &Worker::doWork);
thread->start();

切勿在工作线程直接调用 UI 控件的函数。若必须执行完一次后更新，可搭配 QtConcurrent::run 与 QFutureWatcher，在其 finished 信号中更新 UI。

界面在耗时操作时冻结怎么办？

立即将耗时操作移出主线程。对于短小但连续的操作（如循环），使用 QCoreApplication::processEvents() 仅能临时缓解，不推荐。正确做法：

• 将计算放入 QtConcurrent::run 或 QThread。
• 如果只是文件 IO 或网络请求，使用 Qt 的异步 API（QNetworkAccessManager 等），它们本身就基于事件循环不会阻塞。
• 显示一个模态的 QProgressDialog 并定期通过 processEvents 保持响应仅作最后手段。

事件机制与信号槽的高级用法

如何过滤或拦截特定事件？

重写 eventFilter 或安装事件过滤器。例如拦截某控件的键盘事件：

class MyWidget : public QWidget {
protected:
    bool eventFilter(QObject *obj, QEvent *event) override {
        if (obj == targetWidget && event->type() == QEvent::KeyPress) {
            // 处理或过滤
            return true; // 拦截事件，不再传递
        }
        return QWidget::eventFilter(obj, event);
    }
};
...
targetWidget->installEventFilter(this);

更简单的场景可重写特定事件处理函数，如 keyPressEvent，但仅限该类自身的控件。

自定义事件有什么用处？如何创建？

自定义事件用于跨组件通信或特殊的队列通知，可携带任意数据。继承 QEvent 并注册 type：

// 头文件
class MyCustomEvent : public QEvent {
public:
    static const QEvent::Type MyType;
    explicit MyCustomEvent(const QString &data);
    QString data() const;
private:
    QString m_data;
};

// 源文件
const QEvent::Type MyCustomEvent::MyType =
    static_cast<QEvent::Type>(QEvent::registerEventType());

// 发送
QCoreApplication::postEvent(receiver, new MyCustomEvent("hello"));
// 接收端重写 customEvent 或 event
void MyObject::customEvent(QEvent *event) {
    if (event->type() == MyCustomEvent::MyType) {
        auto *myEvent = static_cast<MyCustomEvent*>(event);
        // 处理
    }
}