idle_t

概述

idle可以看作是duration为0的定时器,不同的是idle函数在主循环中paint之后执行。

idle可以用来实现一些异步处理。

示例:

  1. static ret_t something_on_idle(const idle_info_t* info) {
  2. widget_t* widget = WIDGET(info->ctx);
  3. edit_t* edit = EDIT(widget);
  4. ...
  5. return RET_REMOVE;
  6. }
  7. ...
  8. idle_add(something_on_idle, edit);

在非GUI线程请用idle_queue。


函数

函数名称 说明
idle_add 增加一个idle。
idle_count 返回idle的个数。
idle_queue 用于非GUI线程增加一个idle,本函数向主循环的事件队列中发送一个增加idle的请求。
idle_remove 删除指定的idle。
idle_set_on_destroy 设置一个回调函数,在idle被销毁时调用(方便脚本语言去释放回调函数)。

idle_add 函数


  • 函数功能:

增加一个idle。

  • 函数原型:
  1. uint32_t idle_add (idle_func_t on_idle, void* ctx);
  • 参数说明:
参数 类型 说明
返回值 uint32_t 返回idle的ID,0表示失败。
on_idle idle_func_t idle回调函数,回调函数返回RET_REPEAT,则下次继续执行,否则自动移出。
ctx void* idle回调函数的上下文。

idle_count 函数


  • 函数功能:

返回idle的个数。

  • 函数原型:
  1. uint32_t idle_count ();
  • 参数说明:
参数 类型 说明
返回值 uint32_t 返回idle的个数。

idle_queue 函数


  • 函数功能:

用于非GUI线程增加一个idle,本函数向主循环的事件队列中发送一个增加idle的请求。

  • 函数原型:
  1. ret_t idle_queue (idle_func_t on_idle, void* ctx);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
on_idle idle_func_t idle回调函数。
ctx void* idle回调函数的上下文。

idle_remove 函数


  • 函数功能:

删除指定的idle。

  • 函数原型:
  1. ret_t idle_remove (uint32_t idle_id);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
idle_id uint32_t idleID。

idle_set_on_destroy 函数


  • 函数功能:

设置一个回调函数,在idle被销毁时调用(方便脚本语言去释放回调函数)。

  • 函数原型:
  1. ret_t idle_set_on_destroy (uint32_t idle_id, tk_destroy_t on_destroy, void* on_destroy_ctx);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
idle_id uint32_t idleID。
on_destroy tk_destroy_t 回调函数。
on_destroy_ctx void* 回调函数上下文。