开发手册

数值输入控件读取地址中的数值；启用输入后，点击控件弹出数字键盘。

核心功能

• 数值显示与输入：读取地址值，启用输入后使用数字键盘修改。
• 格式转换：支持整数、小数、浮点数、补零、单位和线性变换。
• 范围控制：可使用固定上下限，也可从地址读取上下限。
• 密码显示：将输入结果显示为掩码。

本节案例：固定范围与可变范围；小数、密码与更多格式。

下载示例工程 · 下载配套素材

打开第 7 页。工程为 1024×600，地址使用 LW（十六进制）。

1. 属性介绍

共用设置：位置尺寸 · 文字与图片 · 执行与声音 · 动态特效 · 安全设置。本节说明控件专有属性，图中序号对应下表。

1.1 功能设置

序号	属性	作用
1～7	输入与键盘	共用设置，见 输入与键盘。
8	读取地址	读取控件需要显示的数据；按工程协议选择地址。
9	写入地址	选择与读取地址相同或不同；不同时填写独立地址。
10	地址	读写分离时，填写独立的写入地址。
11	数据类型	选择与设备数据一致的整数或浮点类型，避免位宽或符号解析错误。
12	整数位数	设置整数部分的显示位数；0 表示自动。
13	前补零	整数位数不足时，在前面补 0。
14	小数位数	设置显示的小数位数；整数类型可按小数位数显示缩放值。
15	后补零	小数位数不足时，在末尾补 0。
16	线性变换	启用后按缩放系数和偏移量换算显示数值。
17	缩放	显示换算的乘数；与偏移共同完成线性变换。
18	偏移	在线性缩放结果上加上的数值。
19	附加单位	显示在数值后的单位文字。
20	无空格	取消数值与单位之间的空格。
21	密码显示	用掩码隐藏实际内容。
22	十六进制	按十六进制格式显示数值。
23	范围限制	选择无、固定范围或可变范围。
24	下限值	比较或限制范围的下边界。
25	上限值	比较或限制范围的上边界。
26	警示色	数值超出范围时，使用下限或上限警示颜色。
27	颜色用途	选择警示色作用于文字还是背景。
28	下限颜色	低于下限时使用的颜色。
29	下限闪烁	低于下限时启用闪烁。
30	上限颜色	高于上限时使用的颜色。
31	上限闪烁	高于上限时启用闪烁。
32	越界数值显示	选择正常显示、符号占位或空白等越界显示方式。
33	键盘越界显示	设置输入超出范围时的处理方式。

1.2 外观设置

序号	属性	作用
1～6	文字与图片	共用设置，见 文字与图片。
7	显示背景	选择无背景、颜色背景或图片背景。
8	背景颜色	设置背景填充颜色。
9	输入背景颜色	启用后，为正在输入的区域指定背景颜色。
10	输入颜色	正在输入时的背景颜色。
11	控制地址	运行时控制所用的寄存器起始地址；本例留空。

1.3 可变范围

序号	属性	作用
1～5	输入与键盘	共用设置，见 输入与键盘。
6～17、20～22	同名属性	含义与本节前面的同名属性相同。
18	下限地址	从该地址读取范围下限。
19	上限地址	从该地址读取范围上限。

1.4 浮点格式

序号	属性	作用
1～5	输入与键盘	共用设置，见 输入与键盘。
6～18	同名属性	含义与本节前面的同名属性相同。

1.5 图片背景

序号	属性	作用
1～6	文字与图片	共用设置，见 文字与图片。
7、9～11	同名属性	含义与本节前面的同名属性相同。
8	背景图片	选择背景图片，或启用图片背景后配置对应图片项。

2. 应用案例

2.1 固定范围与可变范围

2.1.1 工程配置

添加两个数值输入控件，启用输入并选择数字键盘。

控件 / 项目	地址 / 对象	设置
固定范围	LW1600	UINT16；下限 0，上限 100
可变范围	LW1601	下限地址 LW1603；上限地址 LW1602
上限按钮	LW1602	分别写入 50、80；LW1603 保持 0

固定范围：0～100：

可变范围：使用上下限地址：

2.1.2 运行预览

输入 65 后保存；将动态上限改为 50，再打开键盘，可看到上限随地址变化。

2.2 小数、密码与更多格式

2.2.1 工程配置

小数案例设置 1 位小数及 ℃ 单位；密码案例启用密码显示。点击“更多格式”可查看补零、有符号数、线性转换和浮点数。

控件 / 项目	地址 / 对象	设置
小数	LW1604	UINT16；1 位小数；整数 253 显示 25.3 ℃
密码	LW1605	启用密码显示
补零 / 有符号数	LW1610 / LW1611	5 位补零 / INT16
线性转换	LW1612	比例 0.1，偏移 5；无小数位
浮点数	LW1614	FLOAT；2 位小数；末尾补零

小数：1 位小数与 ℃ 单位：

密码显示与输入键盘：

线性变换：缩放 0.1，偏移 5：

FLOAT：2 位小数与末尾补零：

2.2.2 运行预览

小数输入按显示值填写；密码用星号显示。FLOAT 占用连续两个字，后续地址需预留。