AWTK中的事件处理函数

emitter实现了通用的事件注册、注销和分发功能，widget对此做了进一步包装，使用起来非常方便。

一、注册控件事件的处理函数

使用widget_on来注册事件处理函数：

  1. /**
  2.  * @method widget_on
  3.  * 注册指定事件的处理函数。
  4.  * @scriptable custom
  5.  * @param {widget_t*} widget 控件对象。
  6.  * @param {event_type_t} type 事件类型。
  7.  * @param {event_func_t} on_event 事件处理函数。
  8.  * @param {void*} ctx 事件处理函数上下文。
  9.  *
  10.  * @return {uint32_t} 返回id，用于widget_off。
  11.  */
  12. uint32_t widget_on(widget_t* widget, event_type_t type, event_func_t on_event, void* ctx);

示例：

  1. static ret_t on_inc(void* ctx, event_t* e) {
  2.   widget_t* progress_bar = (widget_t*)ctx;
  3.   uint8_t value = (PROGRESS_BAR(progress_bar)->value + 10) % 100;
  4.   progress_bar_set_value(progress_bar, value);
  5.   (void)e;
  6.   return RET_OK;
  7. }
  9. ...
  11. progress_bar = progress_bar_create(win, 10, 80, 168, 30);
  12. widget_set_value(progress_bar, 40);
  14. ok = button_create(win, 10, 5, 80, 30);
  15. widget_set_text(ok, L"Inc"); 
  16. widget_on(ok, EVT_CLICK, on_inc, progress_bar);
  17. ...

在上面这个例子中，我们创建了一个进度条和一个按钮，并为按钮的『点击』事件注册一个处理函数，当按钮被点击时，增加进度条的值。

二、注销控件事件的处理函数

由于窗口关闭时会销毁其中所有控件，所以一般不需要手工去注销。如果确实需要，可以使用widget_off:

  1. /**
  2.  * @method widget_off
  3.  * 注销指定事件的处理函数。
  4.  * @scriptable custom
  5.  * @param {widget_t*} widget 控件对象。
  6.  * @param {uint32_t} id widget_on返回的ID。
  7.  *
  8.  * @return {ret_t} 返回RET_OK表示成功，否则表示失败。
  9.  */
  10. ret_t widget_off(widget_t* widget, uint32_t id);

三、控件分发事件

一般只有在控件内部实现中，或者需要向控件注入事件时，才需要调用事件分发函数。如果需要分发事件，可以调用widget_dispatch：

  1. /**
  2.  * @method widget_dispatch
  3.  * 分发一个事件。
  4.  * @private
  5.  * @param {widget_t*} widget 控件对象。
  6.  * @param {event_t*} e 事件。
  7.  *
  8.  * @return {ret_t} 返回RET_OK表示成功，否则表示失败。
  9.  */