mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-11-30 11:08:34 +08:00
2.5 KiB
2.5 KiB
keyboard_t
概述
软键盘。
软键盘是一个特殊的窗口，由编辑器通过输入法自动打开和关闭。
这里介绍一下定制软键盘的方法：
编辑器输入类型和软键盘UI资源文件的对应关系:
| 输入类型 | 软键盘UI资源文件 |
|---|---|
| INPUT_PHONE | kb_phone.xml |
| INPUT_INT | kb_int.xml |
| INPUT_FLOAT | kb_float.xml |
| INPUT_UINT | kb_uint.xml |
| INPUT_UFLOAT | kb_ufloat.xml |
| INPUT_HEX | kb_hex.xml |
| INPUT_EMAIL | kb_ascii.xml |
| INPUT_PASSWORD | kb_ascii.xml |
| INPUT_CUSTOM | 使用自定义的键盘 |
| 其它 | kb_default.xml |
keyboard中按钮子控件的名称有些特殊要求：
| 名称 | 功能 |
|---|---|
| return | 回车键 |
| action | 定制按钮 |
| backspace | 删除键 |
| space | 空格键 |
| close | 关闭软键盘 |
| 前缀key: | 键值 |
| 前缀page: | 切换到页面 |
更多用法请参考： kb_default
函数
| 函数名称 | 说明 |
|---|---|
| keyboard_close | 关闭keyboard窗口。 |
| keyboard_create | 创建keyboard对象 |
keyboard_close 函数
- 函数功能：
关闭keyboard窗口。
- 函数原型：
ret_t keyboard_close (widget_t* parent);
- 参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| 返回值 | ret_t | 返回RET_OK表示成功，否则表示失败。 |
| parent | widget_t* | keyboard对象。 |
keyboard_create 函数
- 函数功能：
创建keyboard对象
- 函数原型：
widget_t* keyboard_create (widget_t* parent, xy_t x, xy_t y, wh_t w, wh_t h);
- 参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| 返回值 | widget_t* | 对象。 |
| parent | widget_t* | 父控件 |
| x | xy_t | x坐标 |
| y | xy_t | y坐标 |
| w | wh_t | 宽度 |
| h | wh_t | 高度 |