开发手册

数据记录将同一条采样中的多个值排列成一行，可按时间查看、翻页和导出。

核心功能

• 数值与字符串记录，支持时间排序。
• 固定前列、横向浏览、时间定位和选中行反馈。
• 配方编辑与范例中的数据库读写。

下载海景版范例 · 全部工程与背景素材

1. 属性说明

位置、字体、触摸伴音、动态特效和操作权限统一见通用属性。下图展开本控件的专有设置，红色序号与表格对应。

1.1 基本设置

序号	属性	作用
1	数据源	按用途绑定资料取样或配方；数据库案例由脚本共享数据。
2	资料取样索引	选择已启用的采样组。索引 0 对应第 1 组。
3	字符串表格	采样类型为字符串时启用，以文本显示记录。
4	字符编码	选择与原始文本一致的编码。
5	时间排序	选择按时间顺序或逆序显示。
6	日期/时间	选择只显示时间、只显示日期或同时显示。
7	通道数量	表格的数据列数，当前版本为 1～256；不含序号和时间列。
8	自动列宽	勾选后按比例铺满控件；取消后使用各列设定宽度。
9	表格设置	逐列设置显示开关、标题和宽度。
10	每页行数	设置当前可见行数。
11	显示滚动条	记录超过显示范围时，显示可拖动的滚动条。
12	增加触控范围	扩大滚动条的可触摸区域。
13	手势滑动	允许在表格内滑动浏览。
14	翻页控制	允许通过控制区切换首页、尾页或相邻页。
15	控制地址	控件运行控制区的起始地址，偏移用途见下表。
16	时间戳定位	按控制区写入的时间戳定位记录日期。
17	选中行通知	将选中行的索引写入控制区，从 0 计数。

1.2 固定列

序号	属性	作用
8	自动列宽	勾选后按比例铺满控件；取消后使用各列设定宽度。
9	固定列数	横向滚动时固定前 1 列或前 2 列；也可不固定。

取消“自动列宽”后按实际列宽显示，超出部分横向滚动。100 通道案例固定前 2 列，序号与时间始终可见。

序号	设置	作用
1	显示	显示或隐藏该列。
2	标题列	标识序号、时间或数据通道。
3	标题文本	输入标题；点击省略号选择文字标签。
4	宽度	设置列宽；取消自动列宽后按设定值显示。

1.3 配方数据

序号	属性	作用
3	配方数据索引	选择工程中的配方组。
4	直接编辑配方	点击表格单元格可输入新值；需要保存时执行配方保存。

1.4 数据库

序号	属性	作用
4	数据库ID	绑定脚本共享的数据库编号。
5	配置数据库	打开数据库配置窗口，设置记录与字段。

1.5 外观

序号	属性	作用
1、2、3	字体与文字	见通用属性。
4	文字对齐	设置内容文字的左、中、右对齐。
5	显示标题	显示表格标题行。
6	标题文字颜色	设置标题行的文字颜色。
7	显示网格	显示行列分隔线。
8	网格颜色	设置行列分隔线的颜色。
9	边框颜色	设置外围边框颜色。
10	显示背景	启用控件背景填充。
11	标题背景颜色	设置标题行背景色。
12	背景颜色	设置内容区背景色。
13	奇偶分行	用两种背景色区分相邻行。
14	背景颜色2	奇偶分行启用后的交替行背景色。

1.6 控制地址

第 10 页的控制区从 LW5000 开始。

地址	用途
LW5000	1 上一页，2 下一页，3 首页，4 尾页。
LW5001	可翻页状态，bit1～bit4 对应上述动作。
LW5002～LW5003	UINT32 时间戳，用于日期定位。
LW5004～LW5005	UINT32 选中行索引，从 0 计数。

采样启停与清空／导出使用采样组自己的地址，不写入表格翻页区。

2. 应用

2.1 采样、停止与清空

第 10 页绑定索引 0：数据 LW3000、LW3001，周期 1 秒，启停 LW4100，命令 LW4200。点击开始，切换预置值；停止后改值不会追加记录。清空后再开始，只显示新的记录。

2.2 导出 CSV

停止采样后点击“导出到SD”。导出的是采样记录，表格中的列显隐不会删除源数据。完成后打开 CSV 核对标题、时间与数据。下载本次导出的 CSV。

本次 Windows 模拟器把 /sdcard 对应到工程所在盘的根目录，例如 D:\sdcard；首次使用需先创建该文件夹。实体屏使用 SD 卡。

2.3 100 通道与固定列

第 12 页绑定索引 11，起始地址 LW3B00、100 个 UINT16。点击“下一组／上一组”浏览后续通道，前两列保持固定。也可下载独立百路范例。

2.4 选中行与日期定位

第 15 页点击记录行，控制区反馈选中索引；“今天记录”按日期定位。范例“第12行”按钮写入的索引值为 11。

2.5 配方编辑

第 21 页选择配方组 0，并启用“直接编辑配方”。点击单元格输入数值，确认后点击“保存配方”。

2.6 数据库保存与重开

第 23 页使用数据库 ID 1。点击新增记录、请求保存，再重开数据库，检查新增行仍在；数据文件由范例脚本管理。

2.7 字符串记录

第 24 页切换批次 A／B 并开始采样。字符串采样组、表格的字符串开关和字符编码应一致；第 25 页提供另一编码的对照。

---

海景：Preveli Palm Beach Panorama 02.JPG，Uoaei1，CC BY-SA 4.0。已裁切并调整明暗，改编图片沿用原许可。