大彩讲堂：VisualHMI软件如何自定义键盘

发布人：大彩科技发布日期：2025-07-15

一、适合范围

适合全系列大彩协议串口屏产品。

二、教程实现

2.1 准备UI素材

准备好相应的美工UI，如图2-1所示。

图2-1 美工UI图

2.2 建立工程

根据串口屏的实际型号，在VisualHMI软件工程管理区域选择“新建工程” ，选择对应的系列和型号，如图2-2所示。

图2-2 新建工程

本例程使用大彩M型7寸电容串口屏HMI80480M070为验证开发平台。

2.3 SysKBMax/SysKBMin

用于数字键盘显示范围限制的最大值、最小值

若数值控件配置了范围限制，如0~100，弹出数值键盘将显示限定的值，如下所示：

图2-3 数值控件配置图

添加2个文字控件、 2个数值控件， 如下图2-4所示：

图2-4 系统数字键盘配置

数值控件，用来显示范围限定的最大值、最小值，配置如下所示：

1.读取地址：最小值，关联$SysKBMin,最大值，关联$SysKBMin

2.权限控制：☑

3.条件地址：$SysKBStatus.1,1-表示数值控件配置了范围限定

·比较：==

·值：1

·无权限时：隐藏控件

文字控件，用来静态文本显示，配置如下所示：

1.权限控制：☑

2.条件地址：$SysKBStatus.1,1-表示数值控件是否配置了范围限定

·比较：==

·值：1

·无权限时：隐藏控件

2.4 SysKBSelect

键盘选择，用于英文大小写、数字符号、全键盘，切换。通过设置 SysKBSelect 值，0-英文，1-数字符号，2-中文，来切换“虚拟按键”不同的键值。SysKBSelect=0，英文模式(a~z、A~Z);SysKBSelect=1,字符模式(!?#123);SysKBSelect=2,中文模式。

键盘界面上，添加2个字设置按钮递增递减，用于SysKBSelect值的修改，3个多状态指示灯，用于SysKBSelect值的显示，如下图2-5所示；

图2-5 键盘选择配置图

2个字设置按钮，控件配置如下所示：

（1）写入地址：$SysKBSelect

（2）操作模式：递增、递减

· 步长：1

· 最小值：0

· 最大值：2

· 循环调节：☑

3 个多状态指示灯，控件配置如下所示：

（1）读取地址：$SysKBSelect

（2）文字状态：☑

· 第一个：S0~S2，依次为 abc，123，中

· 第二个：S0~S2，依次为中，abc，123

· 第三个：S0~S2，依次为 123，中，abc

图2-6 多状态指示灯控件配置图

2.5 SysKBPinyin/SysKBHanzi

用于显示中文输入的拼音、 预选汉字的显示。

2.5.1 配置

键盘界面，添加两个文本控件，分别关联SysPinying、SysKBHan，配置如下所示：

图2-7 拼音输入、预选汉字配置图

2.5.2 预览

图2-8 拼音输入、预选汉字预览

2.6 SysKBText

用于显示键盘录入的数据

2.6.1 配置

键盘界面，添加1个文本控件，关联 SysKBText，配置下所示：

图2-9 syskbtext 配置图

2.6.2 预览

弹出键盘，输入“123abcABC 大彩”，如下所示：

图2-10 syskbtext预览图

三、虚拟按键

四、弹出键盘应用