awtk/docs/how_to_set_keyboard_visible_num.md

23 lines
1.0 KiB
Markdown
Raw Normal View History

2024-11-11 19:07:50 +08:00
# 如何设置软键盘候选词可见个数
软键盘默认情况下一行的候选词会比较多如果用户想调整候选词的可见个数AWTK也支持了此功能本篇文章将介绍如何使用该功能。
## 1. 新建软键盘
如果工程中还没有软键盘,可以参考文档[《如何添加中文输入法》](https://z.zlg.cn/articleinfo?id=853284)新建软键盘以及添加中文输入法。
## 2. 设置候选词控件的可见个数属性
调整候选词可见个数的属性名称是“visible_num”可以直接在AWTK Designer给candidates控件添加自定义属性的形式修改
![给candidates控件添加自定义visible_num属性](images/candidates_visible_num.png)
或者可以直接修改keyboard的xml文件添加visible_num属性
```xml
<candidates x="0" y="0" w="100%" h="30" enable_preview="true" visible_num="7"/>
```
修改后在AWTK Designer重新打包资源文件并编译工程运行程序预览效果
![软键盘限制候选词可见个数效果](images/keyboard_visible_num.png)