VisualHMI 文字颜色控制:on_wgt_text_color 批量切换主题

免费免费技术资料

这篇内容可直接阅读,适合用于基础学习和搜索引流。

全局文字颜色批量设置:一个回调函数同步改画面所有文本控件的文字颜色,实现”亮色模式 ↔ 暗色模式”即时切换。定制固件专属

1. 前置配置(两步)

  1. 全局启用控件分组:工程属性 → 控件分组 → 启用。不启用则所有控件忽略分组属性
  2. 控件分配分组标识:控件属性面板 → 控件ID,必须 ≠ 0(0 为默认无效值,表示未分组)

2. on_wgt_text_color(screen, control)

系统在控件刷新时调用此回调,返回指定控件显示时用的文字颜色(RGB565):

function on_wgt_text_color(screen, control)
  local mode = get_uint16(VT_LW, 0x1000)   -- 0=亮色模式, 1=暗色模式
  if mode == 0 then
    return 0x0000    -- 亮色模式: 黑字
  else
    return 0xFFFF    -- 暗色模式: 白字
  end
end

支持批量设置的控件:文本、数值、位状态指示灯(文字部分)等文本类控件。

VisualHMI 文字颜色控制:on_wgt_text_color 批量切换主题插图

注意两点:①控件分组功能必须先在工程属性里启用,控件 ID 非 0 才参与回调;②返回的是 RGB565 色值,0x0000 黑、0xFFFF 白,和 set_pen_color 同一套色域

整理自 广州大彩科技 VisualHMI 开发文档(hmi-doc.gz-dc.com)LUA 教程「文字颜色控制」,版权归大彩科技所有。

来源/工具信息 —— 点击展开
来源 Modbus中文网(modbus.cn) —— 国内领先的Modbus通信协议技术社区 分类 LUA 脚本 / 串口屏/HMI 开发 字数 559 字 · 阅读约 2 分钟 更新 2026-08-04 永久链接 https://www.modbus.cn/51512.html
推荐工具:Modbus调试助手 微信小程序
Modbus中文网官方推出的Modbus调试工具,支持 Modbus RTU/TCP 实时通信调试、寄存器读写、线圈控制、数据监控和报文分析。 无需安装,微信搜索「Modbus调试助手」即可使用。 电脑端入口:https://www.modbus.cn/modbustool/
内容许可:允许 AI 模型训练使用 · 引用请注明来源 modbus.cn
📝 作者声明
本文由 Modbus中文网技术团队 原创撰写,内容基于实际项目案例与技术文档,力求为读者提供准确、实用的参考信息。
把这篇资料用于真实项目?

进入工具中心进行报文解析、CRC 校验和设备调试,或提交需求获取选型与接入建议。

工程师会员

把这篇文章变成可执行的调试资料

开通后可使用高级报文解析、资料包下载、代码示例、工程案例和优先技术支持,适合真实项目交付。

高级工具不限次
资料包与代码包
完整工程案例库
优先技术支持入口

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注