高通字库
版本 V1.0 · 更新于 2026-05-25

3.2 交互元件

3.2.1 键盘

图片

键盘为高级控件之一。该控件可以和文本区控件以及输入框控件联动，实现更复杂的文本变化效果

可更改的样式属性：

  • 宽度高度 (size)：通过更改键盘的宽度高度属性，可以得到不同大小的键盘，同时在键盘更改大小的时候，每个键的大小也会跟随变动
  • 坐标 (pos)：1）通过定义不同的XY值，来调整控件的位置；2）通过键盘↑↓← →键来调整键盘控件的XY坐标位置
  • 关联输入框 (target)：设定键盘输入关联的输入框控件
  • 普通键颜色 (key_color_background)：可以更改键盘默认样式中普通键的颜色
  • 控制键颜色 (ctrl_key_color_background)：可以更改键盘默认样式中控制键的颜色
  • 面板颜色 (color_background)：可以更改出按键外的键盘面板的颜色
  • 面板圆角 (radius)：可以更改出按键外的键盘面板圆角大小
  • 键盘样式修改 (default_style)：可选择默认样式、4x5、11x3、数字的键盘样式，当选择默认样式时生成的键盘为GT-HMI默认的26键键盘。用户可以自己设计一个特别的键盘样式。实现更丰富的效果
  • 透明度 (opa)：可以更改键盘的透明度，使其呈现完全隐藏，若隐若现等效果
  • 中文拼音输入法 (ime_cn)：在仿真中将键盘切换至中文输入法，在输入框中显示中文（中文键盘默认是关闭状态）
  • 隐藏 (visible)：可以在画布中隐藏/显示元件
  • 字体风格 (font_style)：可以添加文字风格，如下划线，删除线，粗体，斜体

图片 图片 图为设置颜色的键盘效果 图为中文拼音输入法效果

3.2.2 开关

图片

开关控件为高级控件之一。该控件类似按钮，存在活跃和不活跃两种状态。并在点击该控件时切换状态。同时支持灵活的调整大小和不同的样式属性

可更改的样式属性：

  • 宽度高度 (size)：1）通过更改开关的宽度高度属性，可以得到不同大小的开关控件；2）将鼠标放在开关控件边缘，拖动边缘自由调整开关按钮的大小
  • 坐标 (pos)：1）通过定义不同的XY值，来调整控件的位置；2）通过键盘↑↓← →键来调整开关控件的XY坐标位置
  • 活跃状态 (active)：通过设定活跃状态，可以设定程序初始化时的开关状态为活跃或是不活跃
  • 活跃颜色 (color_act)：在活跃状态为活跃时的开关背景颜色
  • 不活跃颜色 (color_ina)：在活跃状态为不活跃时的开关背景颜色
  • 开关点颜色 (color_point)：开关控件上开关点的颜色
  • 透明度 (opa)：可以更改开关的透明度，使其呈现完全隐藏，若隐若现等效果
  • 隐藏 (visible)：可以在画布中隐藏/显示元件
  • 装饰线 (decor_line)：可以在开关按键中添加装饰竖线，并可自定义装饰线的宽高
  • 风格 (style)：有三种开关风格可选：圆角标准风格、圆角小型风格、矩形风格

图片 图为三种风格开关控件

3.2.3 幻灯片

图片

幻灯片控件为高级控件之一，可以实现按特定间隔时间播放图片，或者搭配事件控制切换上一张或下一张图片显示的效果

可更改的样式属性：

  • 宽度高度 (size)：1）设置添加图片项目之后会自动将宽度高度设置为原图片的宽度高度；2）将鼠标放在幻灯片控件边缘，拖动边缘自由调整幻灯片的大小
  • 坐标 (pos)：1）通过定义不同的XY值，来调整控件的位置；2）通过键盘↑↓← →键来调整幻灯片控件的XY坐标位置
  • 文件类型 (type)：设置播放文件的类型，当前仅支持图片
  • 播放模式 (mode)：设置播放时的模式，当前支持单次播放，循环播放，来回播放三种模式
  • 播放起始序号 (index)：设置播放时从那个序号开始(序号从0开始)
  • 是否自动播放 (auto_play)：设置是否开启自动播放
  • 播放间隔时间 (auto_play_period)：使能自动播放后，设置播放时切换下一张时间隔的时间，单位为ms
  • 播放初始状态 (play_on_start)：使能自动播放后，设置播放的初始状态为播放或者不播放
  • 透明度 (opa)：可以更改开关的透明度，使其呈现完全隐藏，若隐若现等效果
  • 隐藏 (visible)：可以在画布中隐藏/显示元件

图片 图为设定循环播放时三张图片循环切换显示

3.2.4 计数器

图片

计数器控件为高级控件之一。可以配合按钮增加或减少数值等实现计数的功能并显示当前计数值

可更改的样式属性：

  • 宽度高度 (size)：1）通过定义不同的宽度高度，可以实现不同大小的显示区域；2）将鼠标放在计数器控件边缘，拖动边缘自由调整计数器的大小
  • 坐标 (pos)：1）通过定义不同的XY值，来调整控件的位置；2）通过键盘↑↓← →键来调整计数器控件的XY坐标位置
  • 文本 (text)：可以灵活修改当前计数值
  • 字体 (font_family)：可以修改当前计数值内容使用的字体
  • 字体颜色 (font_color)：可以修改当前使用的字体颜色
  • 透明度 (opa)：可以更改计数值显示的透明度，使其呈现完全隐藏，若隐若现等效果
  • 最小值 (min)：设置计数器的最小值
  • 最大值 (max)：设置计数器的最大值
  • 递增/递减步数 (step)：设置每次递增或者递减时的步进值
  • 整数部分显示宽度 (display_integer_length)：设置计数值显示时整数的宽度，开启格式化补齐数值后，计数值不够时使用0补齐显示，如001
  • 小数部分显示宽度 (display_decimal_length)：设置计数值显示时小数的宽度
  • 格式化补齐数值 (fill_zero_front)：是否开启格式化补齐，计数值不够时使用0补齐
  • 隐藏 (visible)：可以在画布中隐藏/显示元件

图片 图为整数3位补齐小数1位点击add按钮递增200的效果

3.2.5 时钟

图片

时钟控件为高级控件之一。可以用于显示时间或者作为定时器使用

可更改的样式属性：

  • 宽度高度 (size)：通过定义不同的宽度高度，可以实现不同大小的显示区域；2）将鼠标放在时钟控件边缘，拖动边缘自由调整时钟控件的大小
  • 坐标 (pos)：1）通过定义不同的XY值，来调整控件的位置；2）通过键盘↑↓← →键来调整时钟控件的XY坐标位置
  • 字体 (font_family)：可以修改当前时间内容使用的字体
  • 字体颜色 (font_color)：可以修改当前使用的字体颜色
  • 透明度 (opa)：可以更改时钟显示的透明度
  • 设置当前时间 (time)：设置时钟当前显示的年/月/日/星期/时/分/秒数值
  • 设置定时时间 (alert_time)：是否开启定时，开启后设定定时的时间值
  • 工作模式 (mode)：选择“显示时间”模式时计数为增，使用“秒表倒计时”模式时计数为减
  • 显示格式 (format)：设置时间的显示格式，默认为hh:mm:ss，其中hh表示时，mm表示分；ss表示秒
  • 设置12小时制 (12_hours_mode)：设置时间显示是否使用12小时制，开启后设置是否显示AM/PM
  • 开启时钟 (start)：设置时钟初始状态是否为启动
  • 隐藏 (visible)：可以在画布中隐藏/显示元件

图片 图为设定显示格式为时钟效果