"# VisualHMI \u6587\u5b57\u989c\u8272\u63a7\u5236\uff1aon_wgt_text_color \u6279\u91cf\u5207\u6362\u4e3b\u9898\n\n> 2026-08-04 | 2026-08-05\n> https:\/\/www.modbus.cn\/51512.html\n\n**LUA \u811a\u672c, \u4e32\u53e3\u5c4f\/HMI \u5f00\u53d1**\n\n---\n\n\u6587\u5b57\u989c\u8272\u63a7\u5236\uff08\u5b9a\u5236\u56fa\u4ef6\u4e13\u5c5e\uff09\u63d0\u4f9b**\u5168\u5c40\u6587\u5b57\u989c\u8272\u6279\u91cf\u8bbe\u7f6e\u63a5\u53e3**\uff1a\u4e00\u4e2a\u56de\u8c03\u51fd\u6570\uff0c\u52a8\u6001\u6539\u753b\u9762\u6240\u6709\u6587\u672c\u7c7b\u63a7\u4ef6\u7684\u6587\u5b57\u524d\u666f\u8272\uff0c\u4e0d\u7528\u9010\u4e2a\u914d\u7f6e\u3002\u5178\u578b\u573a\u666f\u662f\u767d\u5929\/\u591c\u95f4\u6a21\u5f0f\u5207\u6362\u2014\u2014\u4eae\u8272\u80cc\u666f\u914d\u6df1\u8272\u6587\u5b57\uff0c\u6697\u8272\u80cc\u666f\u914d\u6d45\u8272\u6587\u5b57\uff0c\u4e00\u4e2a\u53d8\u91cf\u63a7\u5236\u5168\u5c40\u4e3b\u9898\u3002\n\n## 1. \u652f\u6301\u6279\u91cf\u8bbe\u7f6e\u7684\u63a7\u4ef6\n\n\u4e0d\u662f\u6240\u6709\u63a7\u4ef6\u90fd\u80fd\u88ab\u8fd9\u4e2a\u63a5\u53e3\u7740\u8272\uff0c\u53ea\u6709\u5e26**\u53ef\u7f16\u7a0b\u6587\u5b57\u989c\u8272\/\u524d\u666f\u8272\u5c5e\u6027**\u7684\u63a7\u4ef6\u624d\u53c2\u4e0e\uff1a\n\n\u63a7\u4ef6\u7c7b\u578b\u8bf4\u660e\u9759\u6001\u6587\u672c\u6700\u76f4\u63a5\u7684\u4f5c\u7528\u5bf9\u8c61\u4f4d\u72b6\u6001\u6307\u793a\u706f \/ \u591a\u72b6\u6001\u6307\u793a\u706f\u6587\u5b57\u90e8\u5206\u968f\u4e3b\u9898\u53d8\u8272\u4f4d\u8bbe\u7f6e\u6309\u94ae \/ \u5b57\u8bbe\u7f6e\u6309\u94ae \/ \u529f\u80fd\u6309\u94ae\u6309\u94ae\u6587\u5b57\u4e0b\u62c9\u9009\u62e9\u6846 \/ \u6eda\u8f6e\u9009\u62e9\u5668\u9009\u9879\u6587\u5b57RTC\u65f6\u95f4\u663e\u793a\n\n![lu016_2.png](https:\/\/www.modbus.cn\/wp-content\/uploads\/2026\/08\/visualhmi\/lu016_2.png)\n\n## 2. \u524d\u7f6e\u914d\u7f6e\uff08\u4e24\u6b65\uff0c\u7f3a\u4e00\u4e0d\u53ef\uff09\n\n**\u7b2c\u4e00\u6b65\uff1a\u5168\u5c40\u542f\u7528\u63a7\u4ef6\u5206\u7ec4\u529f\u80fd\u3002**\u8def\u5f84\uff1a\u5de5\u7a0b\u5c5e\u6027 \u2192 \u63a7\u4ef6\u5206\u7ec4 \u2192 \u542f\u7528\u3002\u4e0d\u542f\u7528\u7684\u8bdd\uff0c\u8fd0\u884c\u65f6\u6240\u6709\u63a7\u4ef6\u90fd\u5ffd\u7565\u5206\u7ec4\u76f8\u5173\u5c5e\u6027\u2014\u2014\u5c31\u7b97\u4f60\u914d\u4e86\u5206\u7ec4 ID \u4e5f\u6ca1\u7528\u3002\n\n**\u7b2c\u4e8c\u6b65\uff1a\u7ed9\u63a7\u4ef6\u5206\u914d\u6709\u6548\u5206\u7ec4\u6807\u8bc6\u3002**\u5bf9\u8981\u7eb3\u5165\u989c\u8272\u7ba1\u7406\u7684\u6bcf\u4e2a\u63a7\u4ef6\uff0c\u5728\u63a7\u4ef6\u5c5e\u6027\u9762\u677f\u91cc\u8bbe\u7f6e**\u63a7\u4ef6 ID**\uff0c\u5fc5\u987b \u2260 0\uff080 \u662f\u9ed8\u8ba4\u65e0\u6548\u503c\uff0c\u8868\u793a\u300c\u672a\u5206\u7ec4\u300d\uff09\u3002on_wgt_text_color \u56de\u8c03\u91cc\u5c31\u662f\u9760\u8fd9\u4e2a ID \u533a\u5206\u63a7\u4ef6\u3002\n\n## 3. API\uff1aon_wgt_text_color(screen, control)\n\n\u63a7\u4ef6\u6587\u5b57\u989c\u8272\u52a8\u6001\u56de\u8c03\u3002\u7cfb\u7edf\u5728\u5237\u65b0\u63a7\u4ef6\u65f6\u8c03\u7528\u5b83\uff0c\u53d6\u8fd4\u56de\u503c\u4f5c\u4e3a\u8be5\u63a7\u4ef6\u7684\u6587\u5b57\u989c\u8272\u3002\n\n\u53c2\u6570\u7c7b\u578b\u8bf4\u660escreennumber\u5f53\u524d\u753b\u9762 ID\uff0c\u7528\u4e8e\u533a\u5206\u591a\u9875\u9762\u4e2d\u7684\u540c\u540d\u63a7\u4ef6controlnumber\u76ee\u6807\u63a7\u4ef6 ID\u3002**\u4ec5\u5f53 control \u2260 0 \u65f6\u89e6\u53d1\u56de\u8c03**\n\n\u8fd4\u56de\u503c\uff1a`color`\uff08number\uff09\uff0cRGB565 \u683c\u5f0f\u7684 16 \u4f4d\u989c\u8272\u503c\u3002\u6574\u4e2a\u989c\u8272\u4e3b\u9898\u903b\u8f91\u90fd\u5728\u8fd9\u4e00\u4e2a\u51fd\u6570\u91cc\u3002\n\n## 4. \u5e94\u7528\u6848\u4f8b\uff1a\u591a\u72b6\u6001\u706f\u5207\u6362\u4e3b\u9898\n\n\u753b\u9762\u5e03\u5c40\uff1a\u4e00\u4e2a**\u591a\u72b6\u6001\u6307\u793a\u706f**\u505a\u989c\u8272\u5207\u6362\u5f00\u5173\uff08\u72b6\u6001 0~4 \u5bf9\u5e94 5 \u79cd\u4e3b\u9898\u8272\uff09\uff0c\u753b\u9762 ID \u8bbe\u4e3a 0\uff1b\u4e0b\u9762\u653e\u4e00\u6279\u652f\u6301\u6587\u5b57\u7740\u8272\u7684\u63a7\u4ef6\uff08\u6587\u672c\u3001\u6309\u94ae\u3001\u6307\u793a\u706f\u3001\u4e0b\u62c9\u6846\u3001\u6eda\u8f6e\u3001RTC\uff09\uff0c\u7edf\u4e00\u8bbe\u7f6e\u63a7\u4ef6 ID \u4e3a 5\u3002\n\nLua \u5728\u56de\u8c03\u91cc\u8bfb\u5bc4\u5b58\u5668 LW3000 \u7684\u503c\u4f5c\u4e3a\u989c\u8272\u7d22\u5f15\uff0c\u8fd4\u56de\u5bf9\u5e94 RGB565 \u8272\u503c\uff1a\n\n```\nfunction on_wgt_text_color(screen, control)\n  local color = 0x001f           -- \u9ed8\u8ba4\u84dd\u8272\n  if screen == 0 then\n    if control == 5 then\n      local val = get_uint16(VT_LW, 0x3000)  -- \u989c\u8272\u7d22\u5f15\n      if val == 0 then\n        color = 0x00FF           -- \u84dd\n      elseif val == 1 then\n        color = 0x0562           -- \u7eff\n      elseif val == 2 then\n        color = 0x0429           -- \u6df1\u7eff\n      elseif val == 3 then\n        color = 0x0177           -- \u9752\n      elseif val == 4 then\n        color = 0xF800           -- \u7ea2\n      end\n    end\n  end\n  print(string.format(\"on_wgt_text_color(%d,%d,%04X)\", screen, control, color))\n  return color\nend\n```\n\n\u8fd0\u884c\u865a\u62df\u5c4f\uff0c\u70b9\u989c\u8272\u5207\u6362\u63a7\u4ef6\uff0c\u6240\u6709\u63a7\u4ef6 ID \u4e3a 5 \u7684 UI \u5143\u7d20\u6587\u5b57\u989c\u8272\u540c\u6b65\u66f4\u65b0\u2014\u2014\u8fd9\u5c31\u662f\u300c\u4e00\u952e\u4e3b\u9898\u5207\u6362\u300d\u7684\u6548\u679c\u3002\n\n\u4e09\u4e2a\u5751\uff1a**\u2460\u63a7\u4ef6\u5206\u7ec4\u5fc5\u987b\u5728\u5de5\u7a0b\u5c5e\u6027\u91cc\u542f\u7528**\uff0c\u5426\u5219\u914d\u4e86 ID \u4e5f\u4e0d\u751f\u6548\uff1b**\u2461\u63a7\u4ef6 ID \u4e0d\u80fd\u4e3a 0**\uff0c0 = \u672a\u5206\u7ec4\u4e0d\u53c2\u4e0e\u56de\u8c03\uff1b**\u2462\u8fd4\u56de\u7684\u662f RGB565 \u8272\u503c**\uff08\u9ad85\u4f4dR\/\u4e2d6\u4f4dG\/\u4f4e5\u4f4dB\uff09\uff0c\u548c set_pen_color\u3001\u6587\u5b57\u989c\u8272\u5c5e\u6027\u540c\u4e00\u5957\u8272\u57df\uff0c\u76f4\u63a5\u6284\u753b\u56fe\u90a3\u5957\u989c\u8272\u5e38\u91cf\u5c31\u884c\u3002\u5b9a\u5236\u56fa\u4ef6\u624d\u6709\u8fd9\u4e2a\u63a5\u53e3\uff0c\u666e\u901a\u56fa\u4ef6\u6ca1\u6709\u3002\n\n\u6574\u7406\u81ea \u5e7f\u5dde\u5927\u5f69\u79d1\u6280 VisualHMI \u5f00\u53d1\u6587\u6863\uff08hmi-doc.gz-dc.com\uff09LUA \u6559\u7a0b\u300c\u6587\u5b57\u989c\u8272\u63a7\u5236\u300d\uff0c\u7248\u6743\u5f52\u5927\u5f69\u79d1\u6280\u6240\u6709\u3002\n\n---\n*modbus.cn*\n"