1. 触摸屏基础与Qt输入框架

各位同学好，我是老张。做嵌入式Qt开发十几年了，今天咱们聊聊触摸屏和Qt输入框架。说实话，很多新手工程师上来就写触摸事件处理，结果要么响应迟钝，要么误触频繁——说白了，就是没搞懂底层原理。

这一章，我带你把触摸屏的“老底”翻出来看看。

1.1 触摸屏工作原理

触摸屏分很多种，但嵌入式设备上最常见的是两种：电阻屏和电容屏。我当年刚入行时，还以为它们原理差不多，结果被一个电阻屏的漂移问题折腾了整整一周。

类型	工作原理	典型场景	优缺点
电阻屏	两层导电薄膜受压接触，检测电压分压	工业控制、医疗设备	成本低、可戴手套操作；不支持多点触控
电容屏	人体电容耦合改变电极间电场，检测电容变化	手机、平板、消费电子	支持多点触控、灵敏度高；成本高

嗯，这里有个关键点：电阻屏输出的是模拟电压值，需要ADC转换；电容屏输出的是数字坐标，内部已经做了处理。这个差异直接影响Qt的事件处理方式。

1.2 Qt事件系统概览

Qt的事件系统，说白了就是一个“消息分发中心”。我习惯把它理解成三层结构：

1. 事件产生层：驱动上报原始触摸数据
2. 事件分发层：QApplication 把事件派发给目标控件
3. 事件处理层：控件重写 event() 或特定事件处理函数

你想想看，每次触摸屏幕，数据要经过这三层才能到达你的代码。哪一层出了问题，都会导致触摸异常。

1.3 触摸事件与鼠标事件的区别

这是很多初学者容易混淆的地方。Qt为了兼容性，默认会把触摸事件模拟成鼠标事件。但两者本质完全不同。

对比项	触摸事件 (QTouchEvent)	鼠标事件 (QMouseEvent)
触发方式	手指触摸屏幕	鼠标按键/移动
多点支持	原生支持多点触控	单点，不支持多点
事件类型	TouchBegin, TouchUpdate, TouchEnd	MousePress, MouseMove, MouseRelease
坐标数据	可包含多个触摸点坐标	只有一个鼠标位置
手势识别	可配合QGestureRecognizer	需要手动计算

为什么会这样？因为Qt的设计哲学是“一次编写，到处运行”。鼠标事件是通用接口，触摸事件是增强特性。但如果你只处理鼠标事件，在触摸屏上会丢失很多信息。

1.4 事件传递流程

咱们用一张图来理解整个流程。这张SVG图我画了好几次才满意，它清晰地展示了从手指触摸到事件处理的完整链路。

从这张图你能看到，触摸事件和鼠标事件在Qt内部是两条并行的路径。默认情况下，Qt会帮你把触摸事件转换成鼠标事件，但如果你需要多点触控，就必须直接处理 QTouchEvent。

1.5 代码示例：区分触摸与鼠标事件

咱们写个简单的例子，看看怎么在同一个控件里区分这两种事件。

class TouchWidget : public QWidget
{
    Q_OBJECT
public:
    explicit TouchWidget(QWidget *parent = nullptr)
        : QWidget(parent)
    {
        // 启用触摸事件接收
        setAttribute(Qt::WA_AcceptTouchEvents);
    }

protected:
    bool event(QEvent *event) override
    {
        switch (event->type()) {
        case QEvent::TouchBegin:
        case QEvent::TouchUpdate:
        case QEvent::TouchEnd: {
            QTouchEvent *touchEvent = static_cast<QTouchEvent*>(event);
            qDebug() << "触摸事件，触摸点数:" << touchEvent->touchPoints().count();
            // 处理触摸事件后，阻止转换为鼠标事件
            event->accept();
            return true;
        }
        case QEvent::MouseButtonPress:
        case QEvent::MouseMove:
        case QEvent::MouseButtonRelease: {
            qDebug() << "鼠标事件（可能是触摸模拟的）";
            break;
        }
        default:
            break;
        }
        return QWidget::event(event);
    }
};

1.6 实际项目中的选择策略

那么问题来了：实际项目中，到底该用触摸事件还是鼠标事件？

我个人习惯这样判断：

• 纯单点操作（按钮点击、滑动条）：用鼠标事件就够了，简单可靠
• 需要多点触控（缩放、旋转、多指手势）：必须用触摸事件
• 混合场景：同时处理两种事件，但要注意事件冲突