keyboard_t

概述

image

软键盘。

软键盘是一个特殊的窗口,由编辑器通过输入法自动打开和关闭。

这里介绍一下定制软键盘的方法:

编辑器输入类型和软键盘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对象(供脚本语言使用)。

  • 函数原型:
  1. widget_t* keyboard_cast (widget_t* widget);
  • 参数说明:
参数 类型 说明
返回值 widget_t* keyboard对象。
widget widget_t* keyboard对象。

keyboard_close 函数


  • 函数功能:

关闭keyboard窗口。

  • 函数原型:
  1. ret_t keyboard_close (widget_t* parent);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
parent widget_t* keyboard对象。

keyboard_create 函数


  • 函数功能:

创建keyboard对象

  • 函数原型:
  1. 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 高度