awtk/docs/manual/input_device_status_t.md

97 lines
3.6 KiB
Markdown
Raw Normal View History

2019-10-17 14:23:01 +08:00
## input\_device\_status\_t
### 概述
2019-11-15 11:33:43 +08:00
输入设备状态管理器。本类仅供窗口管理器内部使用。
2019-10-17 14:23:01 +08:00
----------------------------------
### 函数
<p id="input_device_status_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
2020-12-08 09:04:40 +08:00
| <a href="#input_device_status_t_input_device_status_abort_all_pressed_keys">input\_device\_status\_abort\_all\_pressed\_keys</a> | 取消全部已经按下的键。 |
2019-10-17 14:23:01 +08:00
| <a href="#input_device_status_t_input_device_status_init">input\_device\_status\_init</a> | 初始化输入设备状态管理器。 |
2023-06-29 10:44:29 +08:00
| <a href="#input_device_status_t_input_device_status_on_ignore_input_event">input\_device\_status\_on\_ignore\_input\_event</a> | 对输入事件进行处理已经按下的指针和键对应的抬起事件会分发给widget其他的事件不会分发。 |
2019-10-17 14:23:01 +08:00
| <a href="#input_device_status_t_input_device_status_on_input_event">input\_device\_status\_on\_input\_event</a> | 对输入事件进行处理然后分发给widget。 |
2020-12-08 09:04:40 +08:00
#### input\_device\_status\_abort\_all\_pressed\_keys 函数
-----------------------
* 函数功能:
> <p id="input_device_status_t_input_device_status_abort_all_pressed_keys">取消全部已经按下的键。
窗口切换时旧窗口按下的键一直不松开会持续触发PRESS可能会干扰新窗口的用户功能。
所在窗口切换时abort全部已经按下的键直到按键松开。
* 函数原型:
```
ret_t input_device_status_abort_all_pressed_keys (input_device_status_t* ids);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| ids | input\_device\_status\_t* | 输入设备状态管理器对象。 |
2019-10-17 14:23:01 +08:00
#### input\_device\_status\_init 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="input_device_status_t_input_device_status_init">初始化输入设备状态管理器。
2019-10-17 14:23:01 +08:00
* 函数原型:
```
input_device_status_t* input_device_status_init (input_device_status_t* ids);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | input\_device\_status\_t* | 返回输入设备状态管理器对象。 |
| ids | input\_device\_status\_t* | 输入设备状态管理器对象。 |
2023-06-29 10:44:29 +08:00
#### input\_device\_status\_on\_ignore\_input\_event 函数
-----------------------
* 函数功能:
> <p id="input_device_status_t_input_device_status_on_ignore_input_event">对输入事件进行处理已经按下的指针和键对应的抬起事件会分发给widget其他的事件不会分发。
* 函数原型:
```
ret_t input_device_status_on_ignore_input_event (input_device_status_t* ids, widget_t* widget, event_t* e);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| ids | input\_device\_status\_t* | 输入设备状态管理器对象。 |
| widget | widget\_t* | 窗口管理器对象。 |
| e | event\_t* | 事件对象。 |
2019-10-17 14:23:01 +08:00
#### input\_device\_status\_on\_input\_event 函数
-----------------------
* 函数功能:
2019-11-15 11:33:43 +08:00
> <p id="input_device_status_t_input_device_status_on_input_event">对输入事件进行处理然后分发给widget。
2019-10-17 14:23:01 +08:00
* 函数原型:
```
ret_t input_device_status_on_input_event (input_device_status_t* ids, widget_t* widget, event_t* e);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功否则表示失败。 |
| ids | input\_device\_status\_t* | 输入设备状态管理器对象。 |
| widget | widget\_t* | 窗口管理器对象。 |
| e | event\_t* | 事件对象。 |