awtk/docs/input_event_flow.md

输入事件处理流程

本文介绍一下 AWTK 中 Pointer 事件和 Key 事件的处理流程。

一、事件处理的三个阶段

第一阶段：子控件处理前。

控件内部实现时，可以重载 on_event_before_children 处理这个阶段的事件。

应用程序开发者可以注册 XXX_BEFORE_CHILDREN 之类的事件处理这个阶段的事件。这些事件包括：

• EVT_POINTER_DOWN_BEFORE_CHILDREN
• EVT_POINTER_MOVE_BEFORE_CHILDREN
• EVT_POINTER_UP_BEFORE_CHILDREN
• EVT_KEY_DOWN_BEFORE_CHILDREN
• EVT_KEY_UP_BEFORE_CHILDREN

第二阶段：子控件处理。

子控件处理时同样遵循这个三个阶段。

第三阶段：子控件处理后。

控件内部实现时，可以重载 on_event 处理这个阶段的事件。

应用程序开发者可以注册正常的 pointer 事件和 key 事件处理这个阶段的事件。这些事件包括：

• EVT_POINTER_DOWN
• EVT_POINTER_MOVE
• EVT_POINTER_UP
• EVT_KEY_DOWN
• EVT_KEY_UP

二、事件终止

如果在某个阶段，处理事件后，不希望后面阶段继续处理，让事件处理函数返回 RET_STOP 即可。