3.0 通用属性

位置、文字样式、执行时机、动画和权限在多种控件中通用，本节统一说明。各控件章节保留完整属性截图，只补充专有参数。

图中序号只对应所在属性组。选项未启用时，相关子项会隐藏；以下截图展开了这些子项。

1. 位置尺寸

序号	属性	作用
1	ID	控件编号，用于脚本和事件定位。
2	X 坐标	控件左上角距页面左边的距离，单位为像素。
3	Y 坐标	控件左上角距页面上边的距离，单位为像素。
4	宽度	控件的水平尺寸，单位为像素。
5	高度	控件的垂直尺寸，单位为像素。
6	注释	填写控件用途，便于在工程中识别。

2. 文字与图片

以下以双状态控件为例。其他控件的字体、对齐、颜色、闪烁和跑马灯设置相同；图片项名称随控件变化。

序号	属性	作用
1	使用图片	启用状态图片显示。
2	状态0图片	位值为 0 时显示的图片。
3	状态1图片	位值为 1 时显示的图片。
4	裁剪	否：图片缩放到控件大小；是：图片缩放到页面大小，再按控件位置截取图块。
5	使用文字	启用状态文字显示，可与图片同时使用。
6	默认字体	选择工程字库中的字体。
7	字体尺寸	设置文字大小。
8	字间距	调整相邻文字的间距。
9	使用标签	否：直接填写文字；是：引用文字标签，支持多语言切换。
10	选择状态	选择 S0 或 S1 编辑对应文字效果；ALL 同时设置两个状态。
11	文字内容	填写当前所选状态的文字；不使用标签时显示。
12	颜色	设置当前所选状态的文字颜色。
13	对齐	设置文字左对齐、居中或右对齐。
14	闪烁	选择无、0.5 秒或 1 秒的文字闪烁效果。
15	跑马灯	设置文字向左、右、上、下移动；选择“无”关闭。
16	速度	设置跑马灯速度，数值越大移动越快；启用跑马灯后显示。
17	详细设置	点击右侧“…”打开多状态文字设置器，集中编辑各状态和多语言文字。

2.1 文字标签

序号	属性	作用
18	文字标签	点击右侧“…”打开文字标签管理器并选择标签；启用“使用标签”后替代“文字内容”。

2.2 详细设置

双击“详细设置”的值，再点击“…”打开多状态文字设置器。选中一个状态，编辑默认文字及各语言文字。

序号	属性	作用
1	状态	S0、S1 对应位值 0、1；选中一行后，下方显示该状态的多语言设置。
2	文字	设置该状态的默认文字。
3	颜色	设置该状态的文字颜色。
4	对齐	设置该状态的文字对齐方式。
5	闪烁	设置该状态的文字闪烁。
6	跑马灯	设置该状态的文字移动方向。
7	速度	设置该状态的跑马灯速度。
8	多语言	列出当前状态及工程中已配置的语言。
9	文字	填写对应语言的文字；留空使用上方默认文字。
10	指定字体	启用后，为当前语言单独设置字体和大小。
11	字体名称	选择当前语言使用的字体。
12	字体尺寸	设置当前语言的文字大小。

数值、文本等控件中的“加粗”“斜体”用于改变字形；“文字颜色”设置字色，“水平对齐”控制文字在控件内的位置。

3. 执行与声音

序号	属性	作用
6	执行时机	选择按下时、松开时或长按时执行。
7	按压时间	长按达到设定时间后执行，范围 500～10000 ms；仅长按时显示。
8	播放声音	启用后，控件操作时播放所选音频。
9	声音文件	选择已导入声音库的 WAV 或 MP3 文件。

点动操作的按下、松开赋值规则见对应控件。触摸伴音与播放声音的区别见下方“安全设置”。

4. 输入与键盘

序号	属性	作用
1	启用输入	启用后可点击输入；关闭时作为只读显示。
2	键盘类型	当前使用弹出键盘。
3	键盘画面	选择工程中的数字或字母键盘页面。
4	键盘位置	选择预设位置，或使用自定义坐标。
5	键盘X坐标	自定义键盘左上角的水平位置。
6	键盘Y坐标	自定义键盘左上角的垂直位置。
7	键盘初始值	将当前内容带入弹出的键盘。

图中 8～16 为文本输入专有参数，见“3.8 文本输入”。日期时间控件的键盘位置选项与此不同，按该节说明设置。

5. 动态特效

先在工程设置中启用动态特效。两组动画分别配置，避免同时修改同一属性。

序号	属性	作用
1	动画0	选择第一组动画：进入、退出、位置、尺寸或透明度变化；“无”表示关闭。
2	播放条件	选择进入画面时触发或指定条件触发；指定条件时显示地址和比较项。
3	条件地址	读取触发条件的地址，按 INT16 比较。
4	比较	选择 ==、!=、<、<=、>、>=、IN（范围内）或 OUT（范围外）。
5	值	填写单值比较的目标值；IN、OUT 时改为下限值和上限值。
6	允许再次触发	启用后，条件再次由不满足变为满足时，可重新触发动画。
7	播放时间	完成一次正向动画的时间，范围 100～60000 ms。
8	延时播放	触发后等待再播放，范围 0～60000 ms。
9	立即设置开始值	有播放延时时，先应用开始值，再等待并播放。
10	开始值	动画起点；位置用像素，透明度为 0～100，尺寸为 4～4096。
11	结束值	动画终点，单位和范围与开始值一致。
12	路径	设置变化节奏：线性、渐入、渐出、渐入渐出、超出回弹或多次反弹。
13	回放	正向播放结束后，交换起止值反向播放。
14	回放延时	反向播放前的等待时间，范围 0～60000 ms。
15	回放时间	完成一次反向动画的时间，范围 100～60000 ms。
16	重播	选择禁止、指定次数或无限重播。
17	重播次数	首次播放后额外重复的轮数；填 3 表示首次加 3 轮。
18	重播延时	每轮重播前的等待时间，范围 0～60000 ms。
19	动画1	第二组独立动画，参数与动画0相同；避免两组同时改变同一属性。

5.1 范围条件

比较选择 IN 或 OUT 时，“值”替换为上下限，其余序号沿用上表。

序号	属性	作用
20	下限值	IN、OUT 比较范围的下边界。
21	上限值	IN、OUT 比较范围的上边界。

6. 安全设置

序号	属性	作用
1	控件权限	按地址条件控制控件的显示或操作权限。
2	启用	启用控件权限判断。
3	条件地址	读取主权限条件的地址。
4	比较	选择主条件的比较关系；IN、OUT 使用范围上下限。
5	值	填写主条件比较的目标值。
6	附加条件	需要组合判断时，配置第二个条件。
7	启用	无：不附加条件；AND：两项均满足；OR：任一项满足。
8	条件地址	读取附加条件的地址。
9	比较	设置附加条件的比较关系。
10	值	填写附加条件比较的目标值。
11	无权限时	选择隐藏控件，或显示但禁止触控。
12	用户等级	按当前用户等级限制操作。
13	启用	启用用户等级判断。
14	最低要求等级	当前用户达到此等级才可操作；同时启用地址权限时，还须满足地址条件。
15	触摸伴音	选择按下时、松开时或无；声音方式由工程设置中的触摸伴音决定。

6.1 范围条件

比较选择 IN 或 OUT 时，“值”替换为上下限，其余序号沿用上表。

序号	属性	作用
16	下限值	主条件选 IN、OUT 时，设置范围的下边界。
17	上限值	主条件选 IN、OUT 时，设置范围的上边界。

触摸伴音使用工程设置中的静音、蜂鸣器或音频方式；“播放声音”使用当前控件选择的声音文件。