awtk/docs/manual/timer_info_t.md

153 lines
4.2 KiB
Markdown
Raw Normal View History

2019-01-03 09:59:18 +08:00
## timer\_info\_t
### 概述
2019-01-12 11:52:46 +08:00
![image](images/timer_info_t_0.png)
2019-11-15 11:33:43 +08:00
单个定时器的信息。
2019-01-15 14:34:05 +08:00
----------------------------------
2019-01-12 11:52:46 +08:00
### 函数
<p id="timer_info_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#timer_info_t_timer_info_cast">timer\_info\_cast</a> | 转换为timer_info对象(供脚本语言使用)。 |
2019-01-03 09:59:18 +08:00
### 属性
<p id="timer_info_t_properties">
2019-01-17 15:56:15 +08:00
| 属性名称 | 类型 | 说明 |
2019-01-03 09:59:18 +08:00
| -------- | ----- | ------------ |
| <a href="#timer_info_t_ctx">ctx</a> | void* | 定时器回调函数的上下文 |
| <a href="#timer_info_t_duration">duration</a> | uint32\_t | 时间间隔(单位为毫秒)。 |
2021-05-11 15:53:22 +08:00
| <a href="#timer_info_t_extra_ctx">extra\_ctx</a> | void* | 定时器回调函数的上下文 |
2019-12-14 13:25:56 +08:00
| <a href="#timer_info_t_id">id</a> | uint32\_t | 定时器的ID |
2019-09-04 14:17:18 +08:00
| <a href="#timer_info_t_now">now</a> | uint64\_t | 当前时间(相对时间,单位为毫秒)。 |
2019-01-03 09:59:18 +08:00
| <a href="#timer_info_t_on_destroy">on\_destroy</a> | tk\_destroy\_t | 定时器销毁时的回调函数。 |
| <a href="#timer_info_t_on_destroy_ctx">on\_destroy\_ctx</a> | void* | 定时器销毁时的回调函数上下文。 |
| <a href="#timer_info_t_on_timer">on\_timer</a> | timer\_func\_t | 定时器回调函数。 |
2019-09-04 14:17:18 +08:00
| <a href="#timer_info_t_start">start</a> | uint64\_t | 起始时间(相对时间,单位为毫秒)。 |
2020-12-08 09:04:40 +08:00
| <a href="#timer_info_t_suspend">suspend</a> | bool\_t | 定时器是否为挂起状态。 |
2019-01-12 11:52:46 +08:00
#### timer\_info\_cast 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_timer_info_cast">转换为timer_info对象(供脚本语言使用)。
2019-10-16 09:02:32 +08:00
2019-01-12 11:52:46 +08:00
* 函数原型:
```
timer_info_t* timer_info_cast (timer_info_t* timer);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | timer\_info\_t* | timer\_info对象。 |
| timer | timer\_info\_t* | timer\_info对象。 |
2019-01-03 09:59:18 +08:00
#### ctx 属性
-----------------------
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_ctx">定时器回调函数的上下文
2019-10-16 09:02:32 +08:00
2019-01-03 09:59:18 +08:00
* 类型void*
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
2019-01-12 11:52:46 +08:00
| 可脚本化 | 是 |
2019-01-03 09:59:18 +08:00
#### duration 属性
-----------------------
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_duration">时间间隔(单位为毫秒)。
2019-10-16 09:02:32 +08:00
2019-01-03 09:59:18 +08:00
* 类型uint32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
2021-05-11 15:53:22 +08:00
#### extra\_ctx 属性
-----------------------
> <p id="timer_info_t_extra_ctx">定时器回调函数的上下文
* 类型void*
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
| 可脚本化 | 是 |
2019-01-03 09:59:18 +08:00
#### id 属性
-----------------------
2019-12-14 13:25:56 +08:00
> <p id="timer_info_t_id">定时器的ID
> 为TK\_INVALID\_ID时表示无效定时器。
2019-01-03 09:59:18 +08:00
* 类型uint32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
2019-01-12 11:52:46 +08:00
| 可脚本化 | 是 |
2019-01-03 09:59:18 +08:00
#### now 属性
-----------------------
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_now">当前时间(相对时间,单位为毫秒)。
2019-10-16 09:02:32 +08:00
2019-09-04 14:17:18 +08:00
* 类型uint64\_t
2019-01-03 09:59:18 +08:00
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
2019-01-12 11:52:46 +08:00
| 可脚本化 | 是 |
2019-01-03 09:59:18 +08:00
#### on\_destroy 属性
-----------------------
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_on_destroy">定时器销毁时的回调函数。
2019-10-16 09:02:32 +08:00
2019-01-03 09:59:18 +08:00
* 类型tk\_destroy\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### on\_destroy\_ctx 属性
-----------------------
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_on_destroy_ctx">定时器销毁时的回调函数上下文。
2019-10-16 09:02:32 +08:00
2019-01-03 09:59:18 +08:00
* 类型void*
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### on\_timer 属性
-----------------------
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_on_timer">定时器回调函数。
2019-10-16 09:02:32 +08:00
2019-01-03 09:59:18 +08:00
* 类型timer\_func\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### start 属性
-----------------------
2019-11-15 11:33:43 +08:00
> <p id="timer_info_t_start">起始时间(相对时间,单位为毫秒)。
2019-10-16 09:02:32 +08:00
2019-09-04 14:17:18 +08:00
* 类型uint64\_t
2019-01-03 09:59:18 +08:00
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
2020-12-08 09:04:40 +08:00
#### suspend 属性
-----------------------
> <p id="timer_info_t_suspend">定时器是否为挂起状态。
* 类型bool\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |