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 | 删除键 |
tab | tab键 |
space | 空格键 |
close | 关闭软键盘 |
前缀key: | 键值 |
前缀page: | 切换到页面 |
更多用法请参考:
kb_default
函数
函数名称 | 说明 |
---|---|
keyboard_cast | 转换为keyboard对象(供脚本语言使用)。 |
keyboard_close | 关闭keyboard窗口。 |
keyboard_create | 创建keyboard对象 |
keyboard_cast 函数
- 函数功能:
转换为keyboard对象(供脚本语言使用)。
- 函数原型:
widget_t* keyboard_cast (widget_t* widget);
- 参数说明:
参数 | 类型 | 说明 |
---|---|---|
返回值 | widget_t* | keyboard对象。 |
widget | widget_t* | 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 | 高度 |