2. 事件类型与分类：搞懂嵌入式GUI里的“消息快递”

做嵌入式GUI开发，说白了就是跟“事件”打交道。你点一下屏幕，按一下按键，甚至定时器滴答一声，背后都是一条条事件在跑。我刚开始接触这块时，总觉得事件就是“点一下、弹一下”，后来踩了不少坑才明白——事件分类搞不清楚，代码迟早要乱成一锅粥。

这一章，咱们就把常见的GUI事件类型掰开揉碎。触摸、按键、定时器、自定义……每种事件怎么来、怎么用、有什么坑，我都会结合项目经验跟你聊透。

2.1 触摸事件：最常用的交互入口

触摸事件是嵌入式GUI里出现频率最高的事件。你想想看，现在的设备哪个不是触屏？从智能手表到工控面板，几乎全靠手指操作。

触摸事件通常分为几个子类型：

按下（Press/Touch Down）：手指接触屏幕的瞬间
移动（Move/Drag）：手指在屏幕上滑动
抬起（Release/Touch Up）：手指离开屏幕
长按（Long Press）：按下后保持一段时间不松开
双击（Double Click）：短时间内两次按下抬起

核心要点：触摸事件的处理必须考虑“抖动”和“误触”。我曾经在一个户外设备项目里，因为没做触摸消抖，用户手指稍微抖一下就触发了两次按下——那体验，别提多糟糕了。

触摸事件的数据结构一般长这样：

typedef struct {
    uint8_t  type;       // 事件类型：按下/移动/抬起
    uint16_t x;          // 触摸点X坐标
    uint16_t y;          // 触摸点Y坐标
    uint32_t timestamp;  // 事件发生的时间戳
    uint8_t  pressure;   // 触摸压力值（如果有）
} TouchEvent_t;

嗯，这里要注意：坐标值一定要跟屏幕分辨率匹配。我见过有人把1024x600的屏配成了800x480的坐标范围，结果点哪里都偏移——排查了半天才发现是坐标映射没做。

2.2 按键事件：物理交互的“老伙计”

别以为现在都是触屏，按键就过时了。工业设备、医疗仪器、车载控制……物理按键依然大量存在。按键事件虽然简单，但处理不好照样出问题。

按键事件的核心类型：

事件类型	触发条件	典型应用
按下（Key Down）	按键被按下	启动某个功能
抬起（Key Up）	按键被释放	停止某个动作
长按（Key Long Press）	按住超过设定时间	快捷操作、强制复位
连击（Key Repeat）	按住后自动重复触发	音量调节、数值增减

个人经验：按键消抖是必修课。硬件上可以加RC滤波，软件上建议用状态机+定时器做消抖。我习惯用10ms的采样周期，连续采样3次一致才判定有效——这个参数在大多数场景下都够用。

按键事件的结构体示例：

typedef struct {
    uint8_t  key_id;     // 按键编号
    uint8_t  event;      // 按下/抬起/长按/连击
    uint32_t duration;   // 按键持续时长（ms）
} KeyEvent_t;

2.3 定时器事件：GUI的“心跳”

定时器事件是嵌入式GUI里最容易被忽视、但又最重要的东西。你想想看，动画刷新、光标闪烁、超时检测、周期性数据更新……哪样离得开定时器？

定时器事件通常分为：

单次定时器（One-shot）：到期触发一次，然后自动停止
周期定时器（Periodic）：每隔固定时间触发一次，直到手动停止
软件定时器（Software Timer）：基于系统滴答（SysTick）实现，不依赖硬件资源

避坑指南：我曾经在一个项目里同时开了8个定时器，结果系统响应变得奇慢。后来才发现，定时器回调函数里不能做耗时操作——你想想看，如果定时器每10ms触发一次，回调里却执行了50ms的任务，那整个事件队列就堵死了。

定时器事件的数据结构：

typedef struct {
    uint8_t  timer_id;   // 定时器ID
    uint8_t  mode;       // 单次/周期
    uint32_t period;     // 周期（ms）
    uint32_t elapsed;    // 已运行时间
    void   (*callback)(void); // 回调函数指针
} TimerEvent_t;

2.4 自定义事件：让GUI“活”起来

系统自带的事件类型毕竟有限。实际项目中，你总会遇到一些“特殊需求”——比如网络数据到达、传感器阈值触发、系统状态变更……这时候就需要自定义事件。

自定义事件的好处很明显：

解耦：不同模块之间通过事件通信，不用直接调用函数
扩展：新增功能时，只需要定义新的事件类型，不用改现有代码
统一：所有事件都走同一个分发机制，代码结构清晰

我一般这样定义自定义事件：

// 自定义事件类型定义
#define EVT_NET_DATA_ARRIVED  0x1001
#define EVT_SENSOR_ALARM      0x1002
#define EVT_BATTERY_LOW       0x1003

// 通用事件结构体
typedef struct {
    uint16_t event_id;    // 事件ID
    uint16_t param_len;   // 参数长度
    void*    param_ptr;   // 参数指针
} CustomEvent_t;

我的习惯：自定义事件的ID从0x1000开始，跟系统事件（0x0000~0x00FF）区分开。这样在事件分发时，可以快速判断是系统事件还是自定义事件，处理逻辑更清晰。

2.5 事件分类全景图

说了这么多，咱们用一张图把事件分类串起来。这张SVG图展示了嵌入式GUI中常见的事件类型及其关系：

2.6 事件处理的通用原则

不管哪种事件类型，有几个原则是通用的。我个人总结为“三要三不要”：

三要：

要统一事件接口：所有事件都用同一个结构体传递，方便扩展
要设置事件优先级：触摸响应比定时器刷新更重要，优先级要区分
要记录事件时间戳：调试时能还原现场，定位问题

三不要：

不要在事件回调里做耗时操作：超过1ms的操作都建议扔到任务队列里
不要忽略事件丢失：如果事件队列满了，要有处理策略（丢弃旧事件或阻塞等待）
不要混用事件类型：触摸事件和按键事件的处理逻辑不同，别放在同一个回调里

嗯，说到事件丢失，我记得有个项目因为事件队列设得太小，快速点击时经常丢事件。后来我把队列深度从8改到32，问题就解决了。所以，队列大小要根据实际场景来定，别拍脑袋。

📚 课程目录

2. 事件类型与分类：搞懂嵌入式GUI里的“消息快递”

2.1 触摸事件：最常用的交互入口

2.2 按键事件：物理交互的“老伙计”

2.3 定时器事件：GUI的“心跳”

2.4 自定义事件：让GUI“活”起来

2.5 事件分类全景图

2.6 事件处理的通用原则