输入法是 GUI 重要的组件之一,虽然实现起来并不是太复杂,但其涉及的组件比较多,理解起来还是比较困难的,这里介绍一下 AWTK 中输入法的内部架构。
在嵌入式系统中,通常没有物理键盘,所以需要在屏幕上实现软键盘。AWTK 中的软键盘是一个普通的窗口,其中的按钮和候选字控件,都是用 AWTK 的 UI 描述文件定义的,可以方便实现各种不同的软键盘。软键盘的描述文件放在 res/raw/ui 目录下,文件名以 kb_打头。
与普通窗口相比,软键盘有以下不同:
为了实现方便,AWTK 中引入了一个 keyboard 的窗口类,在设计时考虑了下面几个问题:
方案: 在软键盘中可以放多个页面,点击切按钮时进行切换。按钮的名字以"page:"开头,即意味着按下该按钮时切换到指定的页面。比如,下面的按钮被点击时就会切换到数字符号键盘:
<button name="page:symnum" style="1:highlight" w="15%" text="123"/>
方案: 为不同输入类型的编辑器提供不同软键盘,这些软键盘有各自的 UI 描述文件。输入类型和 UI 描述文件名之间的对应关系如下:
输入类型 | 键盘描述文件 | 说明 |
---|---|---|
INPUT_PHONE | kb_phone | 电话号码 |
INPUT_INT | kb_int | 整数 |
INPUT_FLOAT | kb_float | 浮点数 |
INPUT_UINT | kb_uint | 非负整数 |
INPUT_UFLOAT | kb_ufloat | 非负浮点数 |
INPUT_HEX | kb_hex | 16 进制 |
INPUT_EMAIL | kb_ascii | 邮件地址 |
INPUT_PASSWORD | kb_ascii | 密码 |
其它 | kb_default |
参考:input_methods/input_method_default.c
方案: 通过按钮的名字决定其功能:
按钮名称 | 功能说明 |
---|---|
return | 回车键 |
action | 定制按钮 |
backspace | 删除键 |
tab | tab键 |
space | 空格键 |
close | 关闭软键盘 |
clear | 清除编辑器的内容 |
cancel | 恢复编辑器的内容 |
back | 关闭当前窗口 |
back_to_home | 返回home窗口 |
前缀key: | 键值 |
前缀hard_key: | 模拟物理键盘 |
前缀page: | 切换到页面 |
前缀opt: | 多个字符选择一个,点击切换到下一个,超时提交字符(用于实现九宫格输入) |
方案: 提供一个候选字控件,可以根据需要加入到软键盘描述文件中。
参考:res/raw/ui/kb_default.xml
详情请参考 keyboard 的文档。
AWTK 作为一个通用的 GUI,需要考虑以下几种情况:
针对上面几种情况,AWTK 提供了三种不同的实现,可以根据需要加入对应的实现:
输入法引擎主要负责将用户的按键转换成一组候选字(这些候选字将在软键盘上的候选字控件上显示出来)。输入法引擎有很多,不同的语言也有不同的输入法引擎。请参考 输入法引擎
编辑器只需要在得到焦点或失去焦点时,请求输入法打开或关闭输入法即可。
在没有触屏的系统中,可能需要用按键来打开、关闭和 toggle 输入法,否则软键盘一旦弹出来,就没有办法关闭了。
我们可以重新定义以下的宏,来实现这个功能。
#ifndef TK_KEY_CLOSE_INPUT_METHOD
#define TK_KEY_CLOSE_INPUT_METHOD TK_KEY_F7
#endif /*TK_KEY_CLOSE_INPUT_METHOD*/
#ifndef TK_KEY_OPEN_INPUT_METHOD
#define TK_KEY_OPEN_INPUT_METHOD TK_KEY_F8
#endif /*TK_KEY_OPEN_INPUT_METHOD*/
#ifndef TK_KEY_TOGGLE_INPUT_METHOD
#define TK_KEY_TOGGLE_INPUT_METHOD TK_KEY_F9
#endif /*TK_KEY_TOGGLE_INPUT_METHOD*/
#define TK_IM_MAX_CANDIDATE_CHARS 32
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。