数据源

1. 概述

数据源是指手表端可以获取到的数据项目，如年、月、日、时、分、秒，还包括运动健康数据等。 数据的具体细节参照《Sifli表盘工具数据对照表》。如果客户有自定义数据源，建议提前在表格中添加好所有的数据源，方便后续配置。

文本(Text),图片(image),指针(Pointer),图组(ImageArray)等控件可以绑定一个数据源，控件绑定数据源后，数据源的变化将同步刷新绑定了它的控件。 可以编辑的数据源，可以通过事件-行为进行修改。

2. 数据源配置

点击工具>数据源管理，进行数据的修改和增删操作。

2.1 数据列表

  1. 搜索:当数据源过多时,在此输入要修改的数据源名称关键词,可以搜索过滤相关数据源。

  2. 恢复:将数据列表恢复到初始状态，移除所有修改。

  3. 新增:创建一个新的数据源。

  4. 编辑:编辑一个现有数据源。

  5. 删除:删除一个现有数据源。

  6. 导出:根据当前的数据源列表生成C格式的数据源枚举头文件。

  7. 关闭:关闭数据源管理页面。

2.2 数据设置

  1. ID：数据源的ID，内容为英文字符+数字

  2. 名称：数据源的名称，用户自行编辑，在导出的头文件中会在枚举值后面进行注释

  3. ModuleId：根据《Sifli表盘工具数据对照表》定义配置。

  4. SecondId：根据《Sifli表盘工具数据对照表》定义配置。

  5. ThirdId：根据《Sifli表盘工具数据对照表》定义配置。

  6. 描述：数据源的说明信息，用于在数据源列表中显示。

  7. 数值范围描述：数据源的数值范围说明，用于在数据源列表中显示。

  8. 数据范围

    1. Min：数据的最小值。

    2. Max：数据的最大值。

  9. 数据类型

    1. 数值：此数据源的内容仅有一个数值。

    2. 数组：此数据源的内容为许多数值，供图表控件使用。

  10. 使用范围

    1. 可普通填充：此数据源允许图组控件进行普通填充。

    2. 可数字填充：此数据源允许图组控件进行数字填充。

    3. 允许编辑：此数据源允许控件或事件修改数值。

  11. 数字填充图片需求：根据数据源的范围，填写此数据源会用到的数字，默认使用0-9的所有数字图片。

  12. 普通填充图片需求：根据数据源的范围，用户在数组普通填充的时候自行选择数据的显示梯度。

  13. 空闲图：数组绑定此数据源以后，是否支持空闲图显示。

2.3 数据样式

点击添加一个数据格式。每个数据都可以添加多个格式，供控件选择使用。

  1. 名称：格式名称

  2. 数据位长：图组控件的数字填充时，整数位+小数位的总长度。

  3. 小数位长：图组控件的数字填充时，小数位的长度。

  4. 左导0：当实际数据的整数部分长度达不到数据位长时，填写0占位。比如02秒。

  5. 右导0：当实际数据的小数部分长度达不到小数位长时，填写0占位。比如12.50公里。

  6. 文本格式

    1. 固件端：固件端的数据占位格式。整数%d,小树%f

    2. 工具端：工具端的数据占位格式。整数填0，1位小数填0.0,以此类推

2.4 数据单位

2.4.1 图组单位

图组进行数字填充时，可以附带单位。 单位的种类有4种,

  • 末尾 数值的末尾，常见如物理单位，比如1km/h.

  • ·头· 数值的开头，比如负数的负号

  • . 数值中间的小数点

  • 空闲 当图组绑定的数据源出于空闲/无数据状态时需要显示的图片。

单位符号:用一个字母来表示，比如m,k.它的作用是SifliGUIBuilder预览时用于文本占位，在设计器中预览效果。 单位名称：在图组属性页面中展示，用于提示用户选择单位图片的含义。

2.4.2 数据源单位

参照SifliGUIBuilder 数据单位对照表

在2.2 数据设置 中，可以给数据源启用单位类别，如上图，一个叫时长-秒的数据源它启用了时间单位类别。此时，下面的格式列表即可启用数值单位。格式列表的第一项为默认单位，这个数据源的名称是时长-秒，那么第一项的数值单位应该选择时间-秒。我们还可以添加不同单位的格式，比如时间-分。这样可以减少创建数据源的个数，有了这个时长-秒的数据源，当界面上要显示时长-分时，只需要选择第二个格式 时长-分即可。工具预览时会自动根据 SifliGUIBuilder 数据单位对照表 中定义的换算关系进行换算。