3. Qt基础回顾

在工业组态软件（SCADA/HMI）开发中，Qt 不仅是一套 GUI 框架，更是一个围绕事件驱动模型构建的完整应用平台。无论是图元编辑器的鼠标拖拽、PLC 数据的实时刷新，还是报警弹窗的触发，其底层都依赖信号与槽（Signals & Slots）的松耦合通信、事件循环（Event Loop）的持续运转，以及布局与样式表对复杂监控界面的高效组织。本章将聚焦这四个核心基础模块，结合工业场景中的典型问题（如高频数据刷新卡顿、控件自适应缩放、QSS 样式不生效等），帮助学员建立扎实的 Qt 工程化思维。

上图展示了本章四个核心知识模块在工业组态软件中的协作关系。信号与槽负责对象间通信，事件循环保证界面响应与定时任务调度，布局管理处理窗口缩放，QSS 则控制最终视觉呈现。下面逐一深入剖析。

3.1 信号与槽机制：工业通信的“神经中枢”

3.1.1 核心原理：从回调函数到类型安全的观察者模式

信号与槽是 Qt 对观察者模式（Observer Pattern）的扩展实现。与传统的函数指针回调不同，Qt 在编译期通过元对象编译器（MOC）生成元信息，使得信号（Signal）与槽（Slot）的连接在运行时可以动态建立、断开，且支持参数类型检查。一个信号可以连接多个槽，一个槽也可以被多个信号触发，这种多对多关系在工业组态中极为实用——例如，一个“PLC 数据更新”信号可以同时触发图元刷新、历史曲线记录和报警判断三个槽函数。

关键特性在于连接方式（Connection Type）：

• DirectConnection：信号发出后立即同步调用槽函数，适用于同一线程内的对象。
• QueuedConnection：信号发出后，槽函数在接收者所在线程的事件循环中排队执行，适用于跨线程通信（如 PLC 采集线程向 UI 线程发送数据）。
• AutoConnection：默认模式，Qt 根据发射信号与接收槽所在线程自动选择上述两种方式。

3.1.2 操作流程：定义、发射与连接

在自定义图元类（如 FlowMeterItem）中，通常需要定义信号来通知外部状态变化。标准流程如下：

1. 在类声明中使用 signals: 关键字声明信号（只需声明，无需实现）。
2. 在需要触发的位置调用 emit signalName(parameters)。
3. 在接收方使用 connect() 函数建立连接，支持函数指针语法（推荐）或字符串语法。

// 图元类头文件
class FlowMeterItem : public QObject {
    Q_OBJECT
public:
    explicit FlowMeterItem(QObject *parent = nullptr);
signals:
    void valueChanged(double newValue);
    void alarmTriggered(int level, const QString &message);
};

// 在 PLC 数据更新时发射信号
void FlowMeterItem::updateFromPLC(double rawValue) {
    if (rawValue > 100.0) {
        emit alarmTriggered(2, QStringLiteral("流量超限"));
    }
    emit valueChanged(rawValue);
}

// 主窗口中连接
connect(flowMeter, &FlowMeterItem::valueChanged,
        this, &MainWindow::onFlowValueChanged);
connect(flowMeter, &FlowMeterItem::alarmTriggered,
        this, &MainWindow::showAlarmPopup, Qt::QueuedConnection);

3.1.3 案例拆解：多图元联动刷新

某水处理监控界面包含 12 个流量计、8 个阀门和 1 个总览面板。要求当任一流量计数值变化时，总览面板的汇总值同步更新，且阀门颜色根据流量状态变化。若采用轮询方式，每 100ms 遍历所有图元，CPU 占用高且响应延迟。改用信号槽后：

实际实施中，将每个流量计的 valueChanged 信号连接到总览面板的 updateSummary() 槽，同时连接到阀门图元的 setColorByFlow() 槽。由于信号槽的松耦合特性，新增图元时只需增加一条 connect 语句，无需修改既有逻辑。

3.2 事件循环：界面流畅与定时任务的基础

3.2.1 核心原理：事件队列与分发机制

Qt 的事件循环（QEventLoop）是一个持续运行的循环，它从事件队列中取出事件（鼠标点击、键盘输入、定时器超时、跨线程信号等），将其分发到对应的 QObject 事件处理函数（如 mousePressEvent、timerEvent）。QCoreApplication::exec() 启动主事件循环，而 QDialog::exec() 则启动一个嵌套的局部事件循环。

在工业组态中，事件循环的阻塞是最大的敌人。如果在一个槽函数中执行耗时的 PLC 读写操作（如等待 500ms 的 TCP 响应），整个 UI 将冻结。解决方案包括：

• 将耗时操作放入工作线程，通过信号槽与 UI 通信。
• 使用 QTimer 将大任务拆分为小片，在事件循环中分步执行。
• 使用 QProcess 或异步 I/O（如 QModbusClient 的异步读写）。

3.2.2 操作流程：定时器与事件过滤

工业监控中常用 QTimer 实现周期性的数据采集或界面刷新。推荐使用 setTimerType(Qt::PreciseTimer) 保证精度，并注意定时器的最小间隔（通常不低于 10ms，否则系统调度开销过大）。

// 创建 100ms 周期的定时器用于 PLC 数据轮询
QTimer *pollTimer = new QTimer(this);
pollTimer->setInterval(100);
pollTimer->setTimerType(Qt::PreciseTimer);
connect(pollTimer, &QTimer::timeout, this, &MainWindow::readPlcData);
pollTimer->start();

// 事件过滤示例：拦截图元双击事件
bool MainWindow::eventFilter(QObject *obj, QEvent *event) {
    if (obj == flowMeterItem && event->type() == QEvent::MouseButtonDblClick) {
        openPropertyDialog();
        return true; // 事件已处理
    }
    return QObject::eventFilter(obj, event);
}

3.2.3 案例拆解：高频数据刷新不卡顿

某 SCADA 系统需要以 50ms 周期刷新 200 个图元的数值显示。若直接在定时器槽中逐个更新 UI，界面帧率会降至 10 FPS 以下。优化方案：

1. 将数据采集与 UI 刷新分离：采集线程每 50ms 读取 PLC 数据，通过信号发送到 UI 线程。
2. UI 线程使用 QTimer 以 100ms 周期批量更新所有图元（合并两次采集数据）。
3. 对于数值变化不敏感的图元（如温度显示），将刷新周期延长至 500ms。

优化后，CPU 占用从 40% 降至 8%，界面操作流畅。关键点在于：事件循环中不应有超过 16ms 的阻塞操作（对应 60 FPS 的帧间隔）。

3.3 常用控件与布局管理：构建自适应监控界面

3.3.1 核心原理：布局系统的弹性伸缩

Qt 布局系统（QLayout 子类）通过尺寸策略（SizePolicy）和拉伸因子（Stretch Factor）自动计算子控件的位置与大小。工业组态界面通常需要适应不同分辨率的工业显示器（从 800×600 到 1920×1080），布局管理是唯一可靠的方案。核心控件包括：

• QWidget：所有 UI 的基类，可设置最小/最大尺寸。
• QLabel：显示文本或图片，常用于数值显示。
• QPushButton：按钮，支持图标和快捷键。
• QLineEdit / QSpinBox：参数输入。
• QTableView / QListView：历史数据表格。
• QGroupBox：分组框，用于逻辑分区。

3.3.2 操作流程：布局嵌套与拉伸因子

一个典型的监控画面布局：顶部为工具栏（水平布局），中间为图元画布（垂直布局，拉伸因子为 1），底部为状态栏（水平布局）。嵌套布局时，注意设置合理的拉伸因子：

// 主窗口布局
QWidget *central = new QWidget(this);
QVBoxLayout *mainLayout = new QVBoxLayout(central);

// 顶部工具栏
QHBoxLayout *toolbarLayout = new QHBoxLayout();
toolbarLayout->addWidget(startBtn);
toolbarLayout->addWidget(stopBtn);
toolbarLayout->addStretch(); // 弹性空白

// 中间画布区域
QWidget *canvasArea = new QWidget;
canvasArea->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
mainLayout->addLayout(toolbarLayout);
mainLayout->addWidget(canvasArea, 1); // 拉伸因子为 1
mainLayout->addWidget(statusBar);

3.3.3 案例拆解：分辨率自适应

某设备需要同时支持 1024×768 和 1920×1080 两种分辨率。若使用坐标（setGeometry），在低分辨率下控件会超出屏幕。改用布局后，所有控件按比例缩放。关键设置：

同时，在 resizeEvent 中根据窗口宽度动态调整图元大小，保证视觉比例协调。

3.4 样式表（QSS）入门：打造工业级视觉风格

3.4.1 核心原理：CSS 子集与选择器

QSS 是 Qt 对 CSS2 的扩展，支持类选择器、ID 选择器、属性选择器和伪状态。它通过 setStyleSheet() 应用，可以作用于单个控件、父窗口或整个应用。在工业组态中，QSS 用于统一按钮风格、报警变色、夜间模式切换等。

关键选择器示例：

• QPushButton：所有按钮。
• #startBtn：对象名为 startBtn 的按钮。
• QLineEdit[readOnly="true"]：只读输入框。
• QPushButton:hover：鼠标悬停状态。
• QPushButton:checked：选中状态（用于可切换按钮）。

3.4.2 操作流程：QSS 文件加载与动态切换

推荐将 QSS 写入独立文件，在程序启动时加载，便于后期维护和主题切换。

// 加载 QSS 文件
QFile styleFile(":/styles/industrial.qss");
if (styleFile.open(QFile::ReadOnly | QFile::Text)) {
    QString styleSheet = QTextStream(&styleFile).readAll();
    qApp->setStyleSheet(styleSheet);
}

// 动态切换主题（如夜间模式）
void MainWindow::switchToNightMode() {
    QFile nightFile(":/styles/night.qss");
    if (nightFile.open(QFile::ReadOnly | QFile::Text)) {
        qApp->setStyleSheet(QTextStream(&nightFile).readAll());
    }
}

3.4.3 案例拆解：报警状态变色

要求：当 PLC 数据超过阈值时，对应的 QLabel 背景变为红色并闪烁。实现方式：

1. 为每个报警标签设置动态属性 alarmLevel。
2. 在 QSS 中使用属性选择器：QLabel[alarmLevel="2"] { background-color: #ff4444; color: white; }。
3. 在槽函数中修改属性并刷新样式：

void MainWindow::onAlarmTriggered(int level) {
    alarmLabel->setProperty("alarmLevel", level);
    // 强制刷新样式
    alarmLabel->style()->unpolish(alarmLabel);
    alarmLabel->style()->polish(alarmLabel);
    alarmLabel->update();
}

这种方式比直接调用 setStyleSheet() 更高效，且便于统一管理。

3.5 本章总结与常见误区复盘

在实际开发中，建议遵循以下原则：信号槽负责逻辑解耦，事件循环保证流畅性，布局管理确保自适应，QSS 统一视觉规范。这四个基础模块是后续实现图元编辑器和 PLC 通信的基石。学员应在练习中重点体会：一个设计良好的 Qt 程序，其 UI 层与业务逻辑层通过信号槽完全隔离，事件循环保持高度响应，布局与样式可独立调整而不影响功能代码。