awtk/docs/manual/timer_info_t.md

159 lines
4.0 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-09-30 17:11:53 +08:00
单个定时器的信息。
2019-08-24 10:35:53 +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 | 时间间隔(单位为毫秒)。 |
| <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 | 起始时间(相对时间,单位为毫秒)。 |
2019-01-03 09:59:18 +08:00
| <a href="#timer_info_t_user_changed_time">user\_changed\_time</a> | bool\_t | 用户是否修改了系统时间。 |
2019-01-12 11:52:46 +08:00
#### timer\_info\_cast 函数
-----------------------
* 函数功能:
2019-09-30 17:11:53 +08:00
> <p id="timer_info_t_timer_info_cast"> 转换为timer_info对象(供脚本语言使用)。
2019-01-12 11:52:46 +08:00
2019-08-24 10:35:53 +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-09-30 17:11:53 +08:00
> <p id="timer_info_t_ctx"> 定时器回调函数的上下文
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +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-09-30 17:11:53 +08:00
> <p id="timer_info_t_duration"> 时间间隔(单位为毫秒)。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +08:00
2019-01-03 09:59:18 +08:00
* 类型uint32\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### id 属性
-----------------------
2019-09-30 17:11:53 +08:00
> <p id="timer_info_t_id"> 定时器的ID
> 为TK\_INVALID\_ID时表示无效定时器。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +08:00
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-09-30 17:11:53 +08:00
> <p id="timer_info_t_now"> 当前时间(相对时间,单位为毫秒)。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +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-09-30 17:11:53 +08:00
> <p id="timer_info_t_on_destroy"> 定时器销毁时的回调函数。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +08:00
2019-01-03 09:59:18 +08:00
* 类型tk\_destroy\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### on\_destroy\_ctx 属性
-----------------------
2019-09-30 17:11:53 +08:00
> <p id="timer_info_t_on_destroy_ctx"> 定时器销毁时的回调函数上下文。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +08:00
2019-01-03 09:59:18 +08:00
* 类型void*
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### on\_timer 属性
-----------------------
2019-09-30 17:11:53 +08:00
> <p id="timer_info_t_on_timer"> 定时器回调函数。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +08:00
2019-01-03 09:59:18 +08:00
* 类型timer\_func\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### start 属性
-----------------------
2019-09-30 17:11:53 +08:00
> <p id="timer_info_t_start"> 起始时间(相对时间,单位为毫秒)。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +08:00
2019-09-04 14:17:18 +08:00
* 类型uint64\_t
2019-01-03 09:59:18 +08:00
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
#### user\_changed\_time 属性
-----------------------
2019-09-30 17:11:53 +08:00
> <p id="timer_info_t_user_changed_time"> 用户是否修改了系统时间。
2019-01-03 09:59:18 +08:00
2019-08-24 10:35:53 +08:00
2019-01-03 09:59:18 +08:00
* 类型bool\_t
| 特性 | 是否支持 |
| -------- | ----- |
| 可直接读取 | 是 |
| 可直接修改 | 否 |
2019-01-12 11:52:46 +08:00
| 可脚本化 | 是 |